中文版 Apple 官方 Swift 教程《The Swift Programming Language》
使用 GitBook 制作,可以直接在线阅读。
Swift 5.0 翻译中,请到 Issues 中认领章节(把 Issue 的 Assignee 设置成你自己就表示认领,不要认领已经有人认领的章节)。
在翻译时可以通过 Calibre 软件对 document 目录下 不同版本的文档进行 diff,检查待更新部分。
diff 操作如下:
将最新文档加入到 Calibre 中,点击 Edit Book,然后在编辑界面选择 File -> Compare to other book 检查各模块的更新内容,详见链接。
- 更新到 Swift 4.2,2019-01-29
- 更新到 Swift 4.1,2018-04-12,感谢@Mylittleswift
- 更新到 Swift 3.0,2016-09-23
如果想做出贡献的话,你可以:
- 参与翻译
- 帮忙校对,挑错别字、病句等等
- 提出修改建议
- 提出术语翻译建议
如果你有兴趣参与项目,请仔细阅读说明:
排版格式和流程说明:
- 翻译排版格式要求参考 SwiftGG 排版指南
- Pull Request 发起方式参考 SwiftGG Pull Request 说明
其他说明:
- 相关术语请严格按照术语表来翻译,如果有问题可以发 Issue 大家一起讨论
- 使用 Markdown 进行翻译,文件名必须使用英文
- 翻译后的文档请放到 source 文件夹下的对应章节中,然后 Pull Request 即可,我们会用 GitBook 编译成网页
- 有其他任何问题都欢迎发 Issue
翻译术语的时候请参考这个对照表:
术语 | 备选翻译 |
---|---|
argument | 实参 |
parameter | 形参 |
associatedtype | 关联类型 |
range | 区间 |
type property | 类型属性 |
Unary operator | 一元运算符 |
Binary operator | 二元运算符 |
Ternary operator | 三元运算符 |
Labeled Statement | 具名语句 |
conform Protocol | 遵循协议 |
availability-condition | 可用性条件 |
fallthrough | 贯穿 |
Branch Statement | 分支语句 |
Control Transfer Statement | 控制传递语句 |
Type Annotation | 类型标注 |
Type Identifier | 类型标识符 |
Metatype Type | 元类型 |
Protocol Composition Type | 复合协议类型 |
associated value | 关联值 |
raw value | 原始值 |
computed property | 计算属性 |
stored property | 存储属性 |
operator | 运算符 |
playground | 不翻译 |
array | 数组 |
dictionary | 字典 |
list | 列表 |
statement | 语句 |
expression | 表达式 |
optional | 可选 |
Implicitly Unwrapped optional | 隐式解包可选值 |
Optional Binding | 可选绑定 |
optional chaining | 可选链 |
collection | 集合 |
convention | 约定 |
iterate | 迭代 |
nest | 嵌套 |
Inheritance | 继承 |
override | 重写 |
base class | 基类 |
Designated Initializer | 指定构造器 |
Convenience Initializer | 便利构造器 |
Automatic Reference Counting | 自动引用计数 |
type inference | 类型推断 |
Type Casting | 类型转换 |
unwrapped | 解包 |
wrapped | 包装 |
note | 注意 |
closure | 闭包 |
tuple | 元组 |
first-class | 一等 |
deinitializer | 析构器 |
Initializer | 构造器 |
initialization | 构造过程 |
deinitialization | 析构过程 |
getter | 不翻译 |
setter | 不翻译 |
subscript | 下标 |
property | 属性 |
attribute | 特性或者属性,根据上下文 |
method | 方法 |
Enumeration | 枚举 |
Structure | 结构体 |
Protocol | 协议 |
Extension | 扩展 |
Generic | 泛型 |
literal value | 字面量 |
alias | 别名 |
Assertion | 断言 |
conditional compilation | 条件编译 |
贡献者列表,感谢大家!
和 苹果官方文档 协议一致:Creative Commons Attribution 4.0 International (CC BY 4.0) License。