Docutils - Python中的文档转换模块介绍

jopen 11年前

Docutils项目的主要是为了创造一套将纯文本转换为一些常用格式的工具,这些常用格式包括:HTML、XML和LaTeX。 

已经支持的包括:
将会被支持的包括:
  • 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.open-open.com/lib/view/home/1355754061963