Commits

G_will  committed d7f9b86

fix

  • Participants
  • Parent commits 179c6e5

Comments (0)

Files changed (1)

-��һ��Python3�ĵ����Ļ���Ŀ
+又一个Python3文档中文化项目
 =============================
 
-��������˵��һ����Python3��׼��ķ��룬�����Ҿ��Ը����������Ŀ�Ļ����������
+几个朋友说想一起做Python3标准库的翻译,于是我就自告奉勇来做项目的基础搭建工作。
 
-�����˽�һ�£�����ZoomQuiet�Ѿ���֯һ����Ŀ�ˣ������https://bitbucket.org/ZoomQuiet/obp.docs-py3-zh
+搜索了解一下,发现ZoomQuiet已经组织一个项目了,在这里:https://bitbucket.org/ZoomQuiet/obp.docs-py3-zh
 
-���ǣ����е㲻̫�õĵط����ǣ�����ZQ����������Ŀ��Ҫ����hg��ʹ�ã�rst���﷨������Ҫ���մ�����������ߡ�
+但是,还有点不太好的地方就是,参与ZQ大妈的这个项目需要掌握hg的使用,rst的语法,并且要按照代码管理流程走。
 
-����һ���Pythonʹ���ߡ������߲��Ƿdz����㡣
+对于一般的Python使用者、爱好者不是非常方便。
 
-����Ϊ�°汾��Sphinx�Ѿ�֧��Gettext��ʽ�Ķ����Ի������Ծ�������������޸Ĺ�������
+又因为新版本的Sphinx已经支持Gettext方式的多语言化,所以就想结合这个特性修改工作流。
 
-���������£�
+工作流如下:
 
-1. Sphinx������ĵ���pot�ļ�������po�ļ���
+1. Sphinx编译出文档的pot文件,生成po文件。
 
-2. ��po�ļ��ŵ�Pootleƽ̨��һ������Django��web����ƽ̨���Ϲ����ֱ�ӷ��롣
+2. 将po文件放到Pootle平台(一个基于Djangoweb翻译平台)上供大家直接翻译。
 
-3. ������õ�po�ļ�����mo�ļ�������push��bitbucket�йܵĿ��С�
+3. 将翻译好的po文件生成mo文件,并且pushbitbucket托管的库中。
 
-4. ʹ��http://readthedocs.org�ķ������������ĵ�
+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��Ŀ������һЩ�޸ġ�
-   �������ٷ��ĵ����µ�ʱ�򣬲��Ǻܺý����Ǩ�ƹ�����
+1. 现在使用的一个特定版本的Python3文档(3.2.2)作为基础。
+   因为分离官方文档的Sphinx项目,做了一些修改。
+   这样当官方文档更新的时候,不是很好将变更迁移过来。
    
-2. ��Ϊ��������Gettext�ķ��뷽ʽ�����ԾͲ��ܽ����ZQ�������Ŀ����Ҫ��ͷ��ʼ��
+2. 因为现在走了Gettext的翻译方式,所以就不能结合起ZQ大妈的项目,需要从头开始。
 
-3. ��Pootleƽ̨���뵽�ϲ�����⵽�����ĵ�������ʱ�������һ�����ҡ�
+3. Pootle平台翻译到合并代码库到生成文档会有延时,大概在一天左右。
 
-P.S. ����ʹ��Pootle����һ̨��ѵ�EC2�ϣ�����΢��ʵ�������ܲ��Ǻܺã����ʹ�õ�ʱ������һЩ��
+P.S. 现在使用Pootle放在一台免费的EC2上,就是微型实例,性能不是很好,大家使用的时候温柔一些。
 
 -------------------------------------------------------------------------------