RestructedText用来写文档 - EAD: Bandit Johnson - 博...

来源:百度文库 编辑:神马文学网 时间:2024/05/05 10:03:04

RestructedText用来写文档 - [Python]

版权声明:转载时请以超链接形式标明文章原始出处和作者信息及本声明
http://johnsonqu.blogbus.com/logs/46125748.html

好吧,我承认最近有点偏执,觉得所有的事情都可以在Linux/Ubuntu下完成,尤其当我自认为是个程序员的时候。

昨天想写个学习笔记,觉得还是按照特定的格式来写会好一些,于是想到了Python的RestructedTextf以及DocUtils库,网上的教程看看就明白了,对于不做论文工作的我来说,Latex可能不太需要,Rst应该是够用了。

环境很简单,下载了docutils就有了很多转换的工具,基本的编辑是在Vim里面作的,用了VST的插件,感觉还不错。常用的命令如下:

Vst foldr:建立folders,长文档有用。

Vst head:把每个section使用的标识符罗列出来

写好了文本文件之后,可以使用下面的命令很容易的生成html文件:

rst2html.py -q TXTFILE HTMLFILE

VST插件自己也带了生成Html的功能,不过,生成的格式与Doctils不同,还是按照标准的来吧。

BTW: 搜索了一下,基于Doctuils有个Sphinx的库,Django等项目的文档都是用它来管理和生成的,Ubuntu下面安装和配置又很简单,就拿来用了。