Swift 4.2 中文文档翻译召集

file

「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 编程语言》

本帖已被设为精华帖!
讨论数量: 1

4.2 的翻译删了,还是换地址换没了?

5年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!