目录
Python中的Docutils模块介绍
什么是Docutils
Docutils项目的主要是为了创造一套将纯文本转换为一些常用格式的工具,这些常用格式包括:HTML、XML和LaTeX。请事先了解 reStructuredText 的基础知识。
已经支持的包括:
独立的文本文件 PEP (Python Enhancement Proposals)
将会被支持的包括:
Python模块或者包中的内联文档 电子邮件(RFC822格式的邮件头、引用、签名和MIME 段) Wiki格式 混合的文档,例如将多个的章节合并到一本书中 所发现的其他文件格式
使用方法
解开下载的压缩包,并安装Docutils,下面的命令会帮助生成所有相关文档。 cd <archive_directory_path>/tools ./buildhtml.py ../
在Windows系统上可以使用:
cd <archive_directory_path>/tools python buildhtml.py ..
如果你已经有了一个.rst文档,你可以使用:
cd <archive_directory_path>/tools python rst2html example.rst example.html
来生成example.rst的HTML文档。