今天在找一个写文档的工具,最后决定使用sphinx ,一阵阅读tutorial后发现没有对中文简体的支持(但是有对zh_TW支持),网上搜索未果后,决定自己写个汉化的包,这样大家使用起来也方便些。
附件是我写的汉化包。下载后放到$PYTHON/lib/site-packages/你的sphinx目录/sphinx/locale/下,然后设置conf.py中的language选项为zh_CN(加引号)
我机子上的目录为:C:\Python25\Lib\site-packages\Sphinx-0.5.1-py2.5.egg\sphinx\locale,大家可以按照自己的目录进行配置。
另外,我发现sphinx生成的文档中的快速搜索,只支持整词匹配的搜索,还有索引对中文而言意义不大。
另外,我发现sphinx生成的文档中的快速搜索,只支持整词匹配的搜索,还有索引对中文而言意义不大。
期待更好的文档工具的出现,或者等自己闲了,自己去写个,:-)