Github:https://github.com/icexmoon/PEP-CN
Gitee:https://gitee.com/icexmoon/PEP-CN
最近学习Python,翻译了几篇PEP,遂突发奇想有没有PEP的系统中文翻译项目,翻了一下Github,有一个现成的项目PEP中文翻译计划,但一来这个项目已经长时间没更新了,二来这个项目有以下缺陷:
所以我在Github创建了这个项目,目的是进行系统性翻译中文版PEP,为Python学习者做出一些贡献。
当然,我个人的力量远远不够,这里还是希望Python爱好者能广泛加入这个项目。
想加入项目或者有任何建议,可以直接在本项目的issue页面发帖。
如果你不了解什么是PEP,可以阅读学习Python,经常见到PEP,那么PEP是什么呢?
为了避免项目PEP中文翻译计划中的不足,这里暂时规定一下规范:
翻译文章必须使用markdown文本作为载体。
如果不会使用markdown,可以阅读从今天开始markdown,相信我,和学习一门编程语言相比,这完全是轻而易举。
在文章开头必须注明PEP原文地址。
在文章末尾必须注明创作者和版权声明,例如:
版权声明:本文由 [**icexmoon**](https://github.com/icexmoon/) 翻译,遵循CC 4.0 BY-SA版权协议。
建议使用 CC 4.0 版权声明,CC 4.0 BY-SA 的意思是可以转载和改编,但必须注明原作者和来源,关于更多 CC 协议的说明可以阅读“知识共享”(CC协议)简单介绍。
所有翻译成果使用本项目的Github仓库进行托管,在目录中直接进行引用,不使用第三方外链。
译文中如果需要插入图片,必须将图片上传到可靠图床后添加进文本。
Markdown-img是我编写的对此有帮助的小工具。
待翻译列表以未链接的形式在目录中展示,主要由其它网络文章推荐和个人口味形成,如果有其它想加入的P待翻译PEP请在issue页面告知。
可以从带翻译列表认领或者自行确认翻译目标。为了避免重复劳动,选定后请提交一个空的markdown文件到分支合并请求进行占位。
建议在译文中保留原始英文段落,采用中英文对照方式,这样更便于纠错和改进。
建议进行全文翻译,如果时间精力有限,可以将未翻译部分以原文方式呈现,只翻译核心内容。
译文使用中文标点,原文中使用md代码块方式包裹的内容也应该依然使用此方式。
译文之外的译者注释部分应当使用md中的注释语法>注释
,例如:>linter指语法检查工具,可以参考[**程序开发中的linter是什么意思?**](https://www.zhihu.com/question/28421865)中的回答,译者注。
译文之外添加的链接可以使用**加粗**
的方式强化显示。
为了尽可能提高翻译内容的一致性,添加了词汇对照表作为专有名词的翻译依据,如果表中没有,可以选择合适的翻译后维护该表。
鼓励在翻译中对必要的相关已翻译或未翻译PEP进行引用,比如:
注意:
Dict
,DefaultDict
,List
,Set
和FrozenSet
主要用于注释返回值。对于参数,最好使用下面定义的抽象集合类型,例如:Mapping
,Sequence
或AbstractSet
。这是解耦思想的体现,即“向上编程”,此外,Python 3.9 通过PEP 585 -- 标准集合中的类型提示泛型废弃了
typing.Dict
等,已经使用dict
等类型泛型进行了统一,译者注。
如果有其他Python爱好者加入,打算组织实现以下计划:
所有已翻译文章列表会展示在这里:
所有连接均为Github链接,如果无法正常访问请前往本项目的Gitee镜像,然后直接访问pep目录下的md文档,或者下载或克隆。
版权声明:本文由 icexmoon 原创,遵循CC 4.0 BY-SA版权协议。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。