Docutils - Python中的文檔轉換模塊介紹

Docutils項目的主要是為了創造一套將純文本轉換為一些常用格式的工具，這些常用格式包括：HTML、XML和LaTeX。 

已經支持的包括：

• 獨立的文本文件
• PEP (Python Enhancement Proposals)

將會被支持的包括：

• Python模塊或者包中的內聯文檔
• 電子郵件（RFC822格式的郵件頭、引用、簽名和MIME 段）
• Wiki格式
• 混合的文檔，例如將多個的章節合并到一本書中
• 所發現的其他文件格式

由以下幾個部分構成：

• 一個軟件包 (包 docutils)
• 很多有用的小工具，在 tools 目錄下，例如 rst2html.py 可以將 reStructuredText 轉換成 HTML 頁面。
• 一套測試用例

Docutils的工具集

• buildhtml.py

  • 可以使用buildhtml.py將目錄下的所有.txt文件轉換成.html文件，該操作也將包含其下的子目錄。使用方法：

    buildhtml.py [options] [<directory> ...]

• rst2html.py

  • 通過使用rst2html.py可以將單獨的reStructuredText文本文件轉換成HTML文件，適用于當前流行的瀏覽器，并支持CSS。

    rst2html.py test.txt test.html

• rstpep2html.py

  • 通過使用rstpep2html.py可以將新的用reStructuredText格式編寫的PEP轉換成HTML。

    rstpep2html.py pep-0287.txt pep-0287.html

• rst2s5.py

  • 使用rst2s5.py可以將單獨的reStructuredText文本文件轉換成符合 S5 規范的(X)HTML文件。

    rst2s5.py slides.txt slides.html

• rst2latex.py

  • 通過使用rst2latex.py可以將單獨的reStructuredText文本文件轉換成LaTeX2e。

    rst2latex.py test.txt test.tex

• rst2xml.py

  • 通過使用rst2xml.py可以將單獨的reStructuredText文本文件轉換成XML文件。這是標準的XML文件。

項目主頁：http://www.baiduhome.net/lib/view/home/1355754061963