翻译python官方文档:如何开始

基础介绍

python官方文档使用sphinx构建,它是一个python库,可以把写好的文档生成网页、PDF等格式,也可交由社区翻译,翻译后可生成对应语言的文档。

transifex是一个支持多人合作翻译的网站,可在网页进行翻译,也可使用命令同步到本地翻译再提交。不同版本的软件之间往往有相同的字符串,这种情况transifex会自动匹配到其他版本中的字符串。

python的文档翻译托管在transifex上,想参与的话,可以到python.org申请帐号,签字同意协议,并申请成为开发者,然后就可以到transifex找到python团队并申请加入了,申请的时候记得写上相关的python.org帐号信息,并发私信给管理员。

通过管理员验证后,就能开始进行网页翻译了。
如果想在本地翻译,或在本地生成文档,就要把相应的po文件下载下来了。

翻译工作流

原始的rst文件可由
   sphinx-build -b gettext . _pot
生成.pot文件,放在_pot文件夹中。
然后生成po文件(这一步不需要自己操作),编辑po文件
sphinx可以直接处理po文件,也可以用命令msgfmt处理成mo文件,然后就能编译了

生成文档

首先下载python源码,比如翻译3.6版本的,就到github下载Tag为3.6的cpython,写此文时刻最新的是3.6.3。下载后,其中Doc文件夹就是文档了,可以使用sphinx相关工具生成文档。

进入Doc目录后,运行命令:

    sphinx-build -D language=zh_CN -b html . _html

就能把中文文档构建到_html文件夹中,-D表示额外参数,-b表示构建目标,此处为网页。

同步po文件

网页上翻译的po文件有456个左右,一个一个点下载,操作量太大了。可以使用python的软件包:transifex-client,来进行同步。

首先关联python团队的python-36项目:

tx set --auto-remote "https://www.transifex.com/python-doc/python-36"

这个过程比较长,网络慢。
下载后的文件也不能直接用……于是稍作修改,用正则替换,把原来的

translations/python-36.about/<lang>.po

换成locales/<lang>/LC_MESSAGES/about.po

注意,还有些有子文件夹,比如library--xml要改成

locales/<lang>/LC_MESSAGES/library/xml.po

然后tx pull -l zh_CN就能把所有文件同步下来了,网页翻译后可再次运行,更新翻译后的文件。如果在本地进行翻译,也可做相应push操作。


有了本地生成的网页,翻译工作方便多了,可随时编译查看,找找感觉

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,699评论 6 513
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,124评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,127评论 0 358
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,342评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,356评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,057评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,654评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,572评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,095评论 1 318
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,205评论 3 339
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,343评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,015评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,704评论 3 332
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,196评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,320评论 1 271
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,690评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,348评论 2 358

推荐阅读更多精彩内容