2009年10月21日星期三

DocUtils

好吧,我承认最近有点偏执,觉得所有的事情都可以在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下面安装和配置又很简单,就拿来用了。

================================================

没有评论:

发表评论

写下你的意见和问题,一起进步。谢谢