Commits

G_will committed 179c6e5

fix readme

Comments (0)

Files changed (1)

+又一个Python3文档中文化项目
+=============================
+
+几个朋友说想一起做Python3标准库的翻译,于是我就自告奉勇来做项目的基础搭建工作。
+
+搜索了解一下,发现ZoomQuiet已经组织一个项目了,在这里:https://bitbucket.org/ZoomQuiet/obp.docs-py3-zh
+
+但是,还有点不太好的地方就是,参与ZQ大妈的这个项目需要掌握hg的使用,rst的语法,并且要按照代码管理流程走。
+
+对于一般的Python使用者、爱好者不是非常方便。
+
+又因为新版本的Sphinx已经支持Gettext方式的多语言化,所以就想结合这个特性修改工作流。
+
+工作流如下:
+
+1. Sphinx编译出文档的pot文件,生成po文件。
+
+2. 将po文件放到Pootle平台(一个基于Django的web翻译平台)上供大家直接翻译。
+
+3. 将翻译好的po文件生成mo文件,并且push到bitbucket托管的库中。
+
+4. 使用http://readthedocs.org的服务生成在线文档
+
+基于这样的想法,已经做了实现,测试可用。
+
+翻译平台在此:
+
+http://python-internal.net/pootle/zh_CN/python3-docs-zh_cn/
+
+在线文档在此:
+
+http://readthedocs.org/docs/python3-docs-zh_cn/
+
+
+当然还有一些缺点:
+
+1. 现在使用的一个特定版本的Python3文档(3.2.2)作为基础。
+   因为分离官方文档的Sphinx项目,做了一些修改。
+   这样当官方文档更新的时候,不是很好将变更迁移过来。
+   
+2. 因为现在走了Gettext的翻译方式,所以就不能结合起ZQ大妈的项目,需要从头开始。
+
+3. 从Pootle平台翻译到合并代码库到生成文档会有延时,大概在一天左右。
+
+P.S. 现在使用Pootle放在一台免费的EC2上,就是微型实例,性能不是很好,大家使用的时候温柔一些。
+
+-------------------------------------------------------------------------------
+
 Python Documentation README
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~