别开心太早, Python 官方文档的翻译差远了

2019-03-30 09:12:54 +08:00
 chinesehuazhou

近几天,很多公众号发布了 Python 官方文档的消息。然而,一个特别奇怪的现象就发生了,让人啼笑皆非。

Python 文档的中文翻译工作一直是“默默无闻”,几个月前,我还吐槽过这件事《再聊聊 Python 中文社区的翻译》,当时我们的进度是 10.3%,远远落后于日本和法国,甚至落后于巴西!

这次所谓的中文版,当然是未完成翻译的残品。刚查了下,整体进度是 19.7%。

有的公众号在发布消息的时候,说明了这不是官宣、不是正式发布版,还指出了中文版的访问地址是隐藏入口。这都是忠于事实的。

然而,怪异的事情就在于,还有一些公众号在发布时,不知怎么误传,这个消息变成了官方正式发布、全部翻译完成、激动人心期盼已久,至于这个隐藏入口跳转问题、下载的文档为何是英文版的问题,则完全无法解释。这带来了极大的误导。

由于曾搜集过 PEP 文档的翻译,我无意中也了解到关于翻译官方文档的一些情况。有以下几个现状吧:

1、人员分散,缺乏核心。就我所见,在 V 站、华蟒邮件组、简书、知乎,分别有不同的人发起过翻译召集或者咨询,然而应者无几,并没有形成过足够大的核心组织。

2、官方的翻译? Python 官方在 2017 年的 PEP-545 中推出了一种翻译模式,各国语言的翻译在协作平台Transifex 上进行。实际上,这才是官方认可的版本,也是最终发布的依据。前文说的进度,就是指在这个平台上的进度。

3、野生的翻译?所谓野生,这里指的是不在Transifex 上的翻译。网上能看到有人零星地翻译了一些部分,但成果没有合入到官方平台上。社区内的译者还是挺多的,能力也有,只是太分散了。邮件组里就有位大佬,他说翻译过 40 多个标准库以及 C 模块的文档,但懒得组织。有人尝试组织过,时间久远的不说,就在去年夏天,某位在 PHP 界知名的站长开了个 Python 社区,召集了一批译者。他们译出了 Python 3.7 官方文档的入门教程部分,然而,后续内容的计划,似乎被放弃了。

关于对待翻译的态度,似乎多数人表示:感兴趣,但是时间少,希望有人牵头组织,可以参与作贡献。我本人也怀着同样的想法。作为参与者、见证者、沾光者就好了,谁愿意花费那么多精力,承担重任,周旋策划,最后可能还讨不到好呢?

写文章是重口难调,翻译文档更是如此,碰上质疑翻译水平的,还可商榷一下,而遇到下面这种杠精,只能是破坏心情。

前面提到的那位站长,提出在他的社区维护一份长久维护的版本。事实上,他们真的做出了点实事,除了入门教程,还完成了两本经典书籍的翻译。然而,他们也招到了非议:不当的“官方文档”措辞、不合入官方使用的平台、网站的商业化运营......

空谈的人总是有他们的理,不对事情做贡献,还无视别人的贡献。诚然,宣称“官方”中文文档,确实不妥,这只是个人 /社区的行为,改正就好了;至于合入官方的途径,只需有翻译成果,也不难做到;最后,一个站点接些贴片广告,哪有什么不妥?

我所了解到的社区翻译情况,大致如上。

总体上,分裂分散现象严重,随性自由之处跟 Python 这语言倒挺像,而各怀能力各出成绩的现象,也跟为数众多的三方模块神似。

也有默默在做事的人。从 4 个月前的 10% ,增长到现在的 20%,我们的翻译进度暴涨,这背后不知有几人在持续作出贡献?而他们还不为人知。

距离官方文档全部译出,还有大步路要走,现实情况得认清。

我总体上是乐观的。所以,最后聊个题外话。

这几天,有个热得不行的话题——996.ICU ,才仅仅一周,Github star 数已经破 10 万,绝对创造纪录了。程序员发起的活动,就是有如此大的力量。

就在本文写作过程中,Python 之父也给了这个项目 star,而且发推声援。

在官方文档的翻译事情上,或许我们是有点脱轨了,不过不要紧,在使用全球最大的同性交友平台上,我们是与国际接轨的。

还有啊,等过完了愚人节,我们还有个节日也是与国际接轨的——国际劳动节,纪念 1886 年芝加哥工人大罢工,确立每日 8 小时工作制的节日。

相关链接:

翻译进度:https://www.transifex.com/python-doc/python-newest

V 站话题:https://neue.v2ex.com/t/477400#reply147

邮件列表:https://groups.google.com/forum/#!topic/python-cn/8H4qhhI6khw

6081 次点击
所在节点    Python
73 条回复
jdhao
2019-03-30 14:46:39 +08:00
@hwdef 哦,你水平高,贴出你写的东西?
silkriver
2019-03-30 15:03:27 +08:00
英文官方文档按条目更新,大多数条目在新版中会被沿用
如果一个条目不能沿用,则会新增一个条目,翻译这个新增条目即可
如果一个条目写错了,则会修改并把对应的翻译清空(有时只是加了个句点……),重新翻译即可(会在建议栏显示旧版翻译供对照)
所以版本更新其实很方便
crab
2019-03-30 15:06:00 +08:00
BlackBerry 这码打得不及格^^
champage
2019-03-30 15:11:00 +08:00
有心建立一个中文的站点,站点有了,模版有了,就是没有时间....
champage.cn
Vitameans
2019-03-30 17:56:30 +08:00
送楼上某位一句话:人贵有自知之明。
DAPTX4869
2019-03-30 18:56:58 +08:00
@jdhao #19 上不上是一回事,泼冷水又是一回事,呵呵
KuzhiBake
2019-03-30 19:02:43 +08:00
@jdhao 什么狗屁逻辑,现在说别人钢筋还有先做点贡献了?
mamahaha
2019-03-30 19:09:38 +08:00
喷翻译的算个毛线啊,喷语言的大把人在。喷翻译的也许比翻译水平高,但喷语言的比编程语言开发者的水平高?不可能吧。
502badgateway
2019-03-30 19:25:58 +08:00
“有英文为啥看中文?搞编程连英文也不会,还是别搞了”的逻辑就跟“项目源码都放这里了为啥要写文档?连源码都不愿看,还是别学了”差不多🤨
shiny
2019-03-30 19:30:25 +08:00
PHP 这边也是这样,做的最好的也差不多是日本。
jdhao
2019-03-30 19:40:33 +08:00
@KuzhiBake 你什么狗屁逻辑,说句话就成了杠精了?
richard1122
2019-03-30 20:17:06 +08:00
之前翻译过一点维基百科。

个人感觉主要是因为英文原始文档太大量,更新太频繁了,仅靠类似开源社区这种组织方式很难跟得上。
Trim21
2019-03-30 20:18:30 +08:00
看到这个帖子去了解了一下怎么参与 python 文档的翻译, 发现挺简单的...


按照 pep( https://www.python.org/dev/peps/pep-0545/)的说法, 有三步需要做:

1. 注册一个 bugs.python.org 的账号, 这个用户名在签 license 的时候会用到.
2. 签 license 介绍: https://www.python.org/psf/contrib/ 具体签署是在这个页面上 https://www.python.org/psf/contrib/contrib-form/ 用的 adobe sign, 填完那个 iframe 里面的几个框就能提交了.
3. 注册 transifex, 选择自己的语言, 并且申请加入 https://www.transifex.com/python-doc/python-newest/

然后等待被允许加入团队, 然后就可以开始翻译了.


翻译是以每段为单位进行的



一时兴起翻译了一小段, 然后一看官方文档发现已经被更新上去了...

https://github.com/python/python-docs-zh-cn
中文的 po 文件在这个仓库里, 有一个 bot 会自动把 transifex 上面的翻译同步到仓库里面去.
Trim21
2019-03-30 20:21:43 +08:00
刚刚发帖的时候才看到这个仓库, 看了一眼 issue, 发现今天正巧是目标进度 20%的日子...
https://github.com/python/python-docs-zh-cn/issues/10
nichijou
2019-03-30 21:29:06 +08:00
这种事儿挺尴尬的

英文好的大多去看英文了,不关心这个项目;

英文差的只能等别人翻;

大多是英文不上不下的可能对这项任务感兴趣,即锻炼英语又锻炼 python,但工作效率可想而知。

中国缺少英文好且热心布道的人。
nichijou
2019-03-30 21:30:19 +08:00
@jdhao 阁下说话怎么自相矛盾,所以看中文技术资料到底是不是原罪?
mondeo
2019-03-30 21:35:39 +08:00
看看这贴下的评论就知道为啥技术资料翻译在中国没市场了,大家都以看英文文档为傲,以看中午翻译文档为耻。反观日本,很多技术资料都有日文翻译,甚至日文版的官方网站
wengjin456123
2019-03-30 22:02:46 +08:00
@shiny PHP 中文还算可以
Mavious
2019-03-30 22:04:55 +08:00
@silkriver
十分赞同。本人非程序猿。0 基础。
但是用简单的 py 编写脚本,解放双手,还是勉强可以做做的。
py 不难,0 基础都能写几行,而且用的人多,教程一吨吨的,面向摆渡“抄”程也很方便。哪里卡壳了搜哪里,总能搜到代码的。
echaos
2019-03-30 22:32:57 +08:00
已经发了 request 不知道会不会让我参与

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/550164

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX