Swift 4.2 中文文档翻译召集
翻译进度 97.93%
56

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 文档,其 翻译团队 认真与严谨的做事态度,值得我们每一个译者去学习。

开始翻译

最后,如果你有兴趣参与,可以直接前往项目地址认领翻译:

项目地址:https://ioscaff.com/docs/the-swift-programming-language/4.2
翻译动态:https://ioscaff.com/docs/the-swift-programming-language/4.2?mode=sections

本帖已被设为精华帖!
本帖由 Aufree 于 5个月前 置顶
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

  • 请注意单词拼写,以及中英文排版,参考此页
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`, 更多语法请见这里 Markdown 语法
  • 支持表情,使用方法请见 Emoji 自动补全来咯,可用的 Emoji 请见 :metal: :point_right: Emoji 列表 :star: :sparkles:
  • 上传图片, 支持拖拽和剪切板黏贴上传, 格式限制 - jpg, png, gif
  • 发布框支持本地存储功能,会在内容变更时保存,「提交」按钮点击时清空
  请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!