Python 3.7 官方文档中文翻译召集

一直以来 Python 中文社区都没有比较稳定的官方翻译文档。互联网上能找到的，不是某个商业机构、就是个人在维护，大部分情况下，随着时间的推移，他们会慢慢失去兴趣而放弃维护。笔者虽然英文阅读没有障碍，但是中文文档阅读起来理解速度还是要快一点，既然找不到，那我们就自己维护一个。

在这里，我想以社区之名，维护一份高品质的 Python 官方中文文档，做到排版精良、翻译质量优秀、保持更新、支持旧版本查看。长久维护，以社区之名来维护是最好的方案，社区上有很多 Python 开发者，大家也会起到监督和一起推进的作用。希望以后 Python 中文文档，你只需要到一个地方看就够啦。

翻译须知：

翻译有利于技能精进，因为高品质的翻译需要你完全理解将要翻译的内容；
遇到不熟悉的内容，可以先利用搜索引擎查阅资料，把这当成一次难得的学习机会；
请不要像机器人一样直译原文，那样你将无法成长；
请仔细阅读并联系上下文，然后用自己的方式表达出来，就如自己在写作；
翻译完成后请朗读一遍，发出声音来，这是高品质翻译的最好检阅方法。

排版要求

请注意单词拼写，以及中英文排版 ------ 参考此页；
英文的左右必须保持一个空白，避免中英文字黏在一起；
排版请与原文保持一致；
必须使用全角标点符号；
必须严格遵循 Markdown 语法；
原文中的双引号（" "）请代换成中文的引号（「」符号怎么打出来见这里）；
「加亮」和「加粗」和「链接」都需要在左右保持一个空格；
代码注释统一要求翻译；
专有名词首字母必须大写。

欢迎你加入我们的翻译团队，直接点击以下链接进入翻译即可。如果你一直想系统性学习下 Python，现在是一个非常好的机会哦，觉得翻译要求能力太高的话，你可以帮助我们 Review，为每一个区块提交改进建议。

参与翻译： https://pythoncaff.com/docs/tutorial/3.7.0

xuanwu

2018-08-07 13:31:31 +08:00

中文版的主要读者如果是英文水平有限的新手, 那么原文档的示例教程有些不大适合. 就入门教程部分说, 除去上面提到的那个字典例程, 还有那几个巨蟒剧团的剧本片段(比如挪威蓝鹦鹉原示例: https://docs.python.org/3/tutorial/controlflow.html#keyword-arguments, 汉化后 https://nobodxbodon.github.io/py36zh/tutorial/controlflow.html#keyword-arguments)就会让人摸不着头脑. 之前中文化例程到第五章就觉得不如重新做一些更有中文特色的示例, 也可以避免对新手的额外的英语文化学习负担.
个人感觉示例代码对于教程 /手册来说非常重要, 很多时候一个清楚 /易懂的示例可以代替一大段说明文字. 而原作的英文示例代码一来年代久远, 二来有不少的文化相关性. 去翻译文档的文字部分而保留原示例代码, 对于译者来说肯定是个锻炼过程, 也可以促进一些术语翻译的一致化, 但对于最终读者的痛点也许不能很好解决.

cncqw

2018-08-07 14:38:11 +08:00

@SimbaPeng

说得很好，楼主自称以社区之名，但是根据已有的社区来看，楼主很可能把做社区卖教程当做一条产业链了，什么技术流行就马上换个主题上线一个社区，模式一模一样，一旦文档翻译完成，或者楼主的教程写完，马上就会放上教程的菜单，收费不低于 69 元，做社区是假卖教程是真

目前这个 Python 社区还没有教程，过段时间大家可以看一下会不会有，事实上 Python 的免费教程到处都是，优质内容也不少，楼主的这个定价偏高，但是依托于这个所谓的社区以及中文官方文档，就可以收割到一大群小白付费购买

当然我对楼主卖教程盈利没有意见，既然盈利就不要说得自己像在做公益，一开口就以社区之名，还到处忽悠找人免费给你翻译文档，这种行为叫挂羊头卖狗肉，是对开源精神的一大侮辱

xuanwu

2018-08-07 14:58:40 +08:00

顺便一说, 之前在 Doc-sig 提出在翻译文档时一并翻译示例程序, 和文档组领头的两位(法语&日语)有些交流. 他们都比较坚定表示代码应该用英文命名. 法语组长的态度中性一些, 还提示了如何实现代码翻译(小结在"搭建 Python 官方文档翻译环境-汉化示例代码"一文: https://zhuanlan.zhihu.com/p/36200420 ). 甚至还提到他教新手时也会用母语命名:

"In the other hand I personally use translated variable names when I teach Python to newcomers, because it helps them to distinguish between "what they can change" and "what they can't", seeing "for 词 in 词表:" make it clear that "for", "in". and ":" are from Python and "词" and "词表" are from the teacher"

日语组长更坚定反对, 开始的一个理由比较意外, 好像是日语不如英语可读:

"In Japan, many Pythonista doesn't use Japanese identifiers regulally.
There are many "looks similar, but different" characters in Japanese.
So ASCII is more readable than Japanese Hanji."

后来一个理由是日语组的目标是 100%翻译(现在是 85%), 而如果引入代码翻译的话, 工作量将会大幅增加. 无论如何, 日语组的毅力还是佩服的.
如果一定要翻译, 还是走官方构建流程吧, 这也是一个增加话语权的途径.

当然, 个人还是觉得翻译和维护的工作量不如新创一套适合中文母语开发者的教程(用中文命名), 也会更受欢迎. 如有兴趣, 欢迎联系. 知乎专栏 https://zhuanlan.zhihu.com/c_140193266 或 github 讨论组 https://github.com/program-in-chinese/overview 都可

hundan

2018-08-07 15:26:40 +08:00

@SimbaPeng 我认为盈利不是一个值得讨论的问题，关键是翻译的同学是否得到了馈赠。
我认为应该有馈赠。
但即使没有馈赠，依然是一个翻译的平台，对于那些希望通过翻译提升自己或服务他人的同学而言。
翻译应该有馈赠，不应当站长独享。但是这不是一个十分让人难以接受的问题，更重要的是翻译的质量，社区的管理维护，会员之间的沟通，商业气息，等等涉及翻译社区本质的事。