12

如何参与 Python 官方文档简体中文翻译

 3 years ago
source link: https://mp.weixin.qq.com/s/x7UO7JecvYjeWfazb6__Tg
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

点击PyChina |关注我们

作者:刘玉龙 | 编辑:果汁

背景及时间线

2019年之前

Python 官方文档 [1] 上只有英、法、日、韩四种语言,虽然当时在中国 Python 的使用率正节节攀登,但官方文档上依然没有中文,只有很多个民间翻译版本。

2018年5月3日

在华蟒用户组,Shengjing Zhu(朱晟菁)再次发起了中文翻译工作 [2],并建立了对应的 GitHub [3],但与之前不同的是,此次翻译参考了日文团队的协作模式,使用了 Transifex 工具 [4],也算是半官方的翻译项目了。

NrQN3e6.png!mobile

2018年10月下旬

为了交流方便,几个翻译者凑在一起建立了微信群,并开始沟通仓库迁移事项。程序员节前,此仓库正式迁移到 Python 目录下 [5],并在初次代码构建后有了可以访问的官方链接,但由于当时的翻译程度并未达到标准,因此未能显式展示出简中页签,只能手动输入链接访问。

Ab6fY3v.png!mobile

2019年3月29日

官方文档中增加了简中页签,可以被所有人直接看到。

ZZjm6b7.png!mobile

2020年1月28日

翻译进度达到 50%。

RryMvan.png!mobile

2020年12月14日

翻译进度达到 60%。

2021-01-29

翻译进度达到 62.12%。

参与翻译方式

翻译工具使用 Transifex,分工协调使用 GitHub issue,都在官方项目下,步骤是:

1. 阅读 readme,阅读 PEP545 [6]

2. 注册 Transifex,并申请加入(语言选择 Chinese (China) zh_CN)

3. 等待审核,一般一两天就会通过

4. 在 issue/6 [7] 里回复自己想要翻译的模块,以避免与其他人冲突

5. 打开 Transifex 开始翻译吧~

Transifex 使用方式

1. 登陆&注册,并申请加入 python document translations 组织,并选择语言 Chinese (China) zh_CN

bMrmEbb.png!mobile

2. 选择版本,建议优先翻译默认版本,默认版本对应的是 Python 3.9 的文档

yAr6B3u.png!mobile

3. 选择相应条目后即可进入翻译工作区开始翻译,内容会定期更新到官网上

Qzme6bY.png!mobile

相关文档

[1]: https://docs.python.org/3/

[2]: https://groups.google.com/g/python-cn/c/8H4qhhI6khw

[3]: https://github.com/zhsj/python-docs-zh-cn 

(现在去看会显示仓库已迁移)

[4]: https://www.transifex.com/python-doc/public/

[5]: https://github.com/python/python-docs-zh-cn

[6]: https://www.python.org/dev/peps/pep-0545/

[7]: https://github.com/python/python-docs-zh-cn/issues/6

关于我们

eIBNfev.jpg!mobile

「PyChina」是 PyChina.org 的官方微信公众号(ID:PyChinaOrg),创立于 2014 年,目前由 PyChina 主理。所有和 PyChina、PyCon China 大会相关的动态都会第一时间在这里发布,除此之外,你还可以在这里看到 Python 相关的技术分享和最新资讯,欢迎关注!

欢迎关注 PyChina 官方账号️  
官网:https://pychina.org
公众号(@PyChinaOrg)


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK