Swift 4.2 中文文档翻译召集
「The Swift Programming Language」是 Apple 官方发布的 Swift 语言文档,基本上每个 Swift 开发者在日常工作或学习中都会频繁查阅。因此,我选择将该文档作为社区的第一个翻译文档,希望大家能一起参与进来,感受协同翻译的魅力。
Q & A
1. 已经有中文文档,为什么还要翻译?
这个问题相信是在我号召翻译之后,大家会问得最多的一个问题,因此我将其摆在首位,统一解答。
首先,文档的翻译并不是在做重复性劳动,我们本质的目的是希望通过文档翻译的方式,来更好的学习 Swift 语言,吸收其语言精华。我一直坚信,翻译英文技术文档是快速提升一个人阅读能力、语言组织能力的最好方式。
其次,目前最新的中文文档是 Swift 4.1,我们即将要翻译的是 Swift 4.2,这二者并不冲突。
最后,现有中文文档都缺乏较好的协同翻译方式和内容改进方式。采用的依旧是传统翻译手段,通常由一人负责整篇文章的翻译,导致翻译工作难度大,周期长。而社区现有提供的分块翻译、Pull Request 改进内容的功能,刚好补足了这一缺点。
2. 文档大概什么时候能翻译完成?
Swift 4.2 需要等到 Xcode 10 发布出来才正式支持,这个时间点大概会在今年 9 月中旬左右,届时希望能通过大家的共同努力,赶在 Xcode 10 正式发布之前将此文档翻译完成。
3. 我想参与翻译,我需要准备什么?
翻译是需要一个人真正沉下心来,逐字逐句的品味原文,要使译文达到信、达、雅的标准,有一颗浮躁的心是做不来的。如果你想通过翻译文档来磨练自己,这也许是个不错的方式。但是当你开始进行翻译时,我希望你能以认真的态度对待,因为我们后面每一段译文都会在其右侧标注上作者姓名,也即是说,你的作品定义了你,因此希望我们能一起用心做好这件事。
在你进行翻译前,请先阅读以下翻译须知:
- 翻译有利于技能精进,因为高品质的翻译需要你 完全理解 将要翻译的内容;
- 遇到不熟悉的内容,可以先利用搜索引擎查阅资料,把这当成一次难得的学习机会;
- 请不要像机器人一样直译原文,那样你将无法成长;
- 请仔细阅读并联系上下文,然后用 自己的方式 表达出来,就如自己在写作;
- 翻译完成后请 朗读一遍,发出声音来,这是高品质翻译的最好检阅方法;
- 请注意单词拼写,以及中英文排版,参考此页,特别注意以下:
- 英文的左右 必须 保持一个空白,避免中英文字黏在一起;
- 排版请与原文保持一致;
- 必须 使用全角标点符号;
- 必须 严格遵循 Markdown 语法;
- 原文中的双引号(" ")请代换成中文的引号(「」符号怎么打出来见 这里);
- 「
加亮
」和「加粗」和「[链接]()」都需要在左右保持一个空格; - 代码注释统一要求翻译;
- 专有名词首字母必须大写;
致敬先驱
在此顺便致敬 梁杰 组织翻译的 Swift 3.0 文档,其 翻译团队 认真与严谨的做事态度,值得我们每一个译者去学习。
开始翻译
最后,如果你有兴趣参与,可以直接前往项目地址认领翻译:
项目地址:《Swift 编程语言》
翻译动态:《Swift 编程语言》
4.2 的翻译删了,还是换地址换没了?