the-swift-programming-language-in-chinese/README.md

《The Swift Programming Language》in Chinese
=============================================

中文版 Apple 官方 Swift 教程《The Swift Programming Language》

[英文原版](https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/index.html#//apple_ref/doc/uid/TP40014097-CH3-ID0)

**如果想帮忙翻译或者校对，请加QQ群：480616051，谢谢！**

# 在线阅读

使用 Gitbook 制作，可以直接[在线阅读](http://swiftguide.cn/)。

# 当前阶段



已经更新到 Swift 3.0。 2016-09-23

# 3.0 译者记录
相关[issue](https://github.com/numbbbbb/the-swift-programming-language-in-chinese/issues/628)
- Functions: [crayygy](https://github.com/crayygy)
- Control Flow: [Realank](https://github.com/Realank)
- Closures: [LanfordCai](https://github.com/LanfordCai)
- Protocols: [chenmingbiao](https://github.com/chenmingbiao)
- The Basics:[chenmingbiao](https://github.com/chenmingbiao)
- Advanced Operators: [mmoaay](https://github.com/mmoaay)

Language Reference:
- Attributes: [WhoJave](https://github.com/WhoJave)
- Statements: [chenmingjia](https://github.com/chenmingjia)
- Declarations: [chenmingjia](https://github.com/chenmingjia)
- Expressions: [chenmingjia](https://github.com/chenmingjia)
- Types: [lettleprince](https://github.com/lettleprince)
- Generic Parameters and Arguments: [chenmingjia](https://github.com/chenmingjia)

# 2.1 & 2.2 译者记录

详见各章节开头位置。

# 2.0 译者记录

- About Swift （[xtymichael](https://github.com/xtymichael)）
- A Swift Tour（[xtymichael](https://github.com/xtymichael)）
- The Basics（[xtymichael](https://github.com/xtymichael)）
- Basic Operators（[AlanMelody](https://github.com/AlanMelody)）
- Strings and Characters（[DianQK](https://github.com/DianQK)）
- Collection Types（[AlanMelody](https://github.com/AlanMelody)）
- Control Flow（[AlanMelody](https://github.com/AlanMelody)）
- Functions（[dreamkidd](https://github.com/dreamkidd)）
- Closures（[100mango](https://github.com/100mango)）
- Enumerations（[futantan](https://github.com/futantan)）
- Classes and Structures（[SkyJean](https://github.com/SkyJean)）
- Properties（[yangsiy](https://github.com/yangsiy)）
- Methods（[DianQK](https://github.com/DianQK)）
- Subscripts（[shanksyang](https://github.com/shanksyang)）
- Inheritance（[shanksyang](https://github.com/shanksyang)）
- Initialization（[chenmingbiao](https://github.com/chenmingbiao)）
- Deinitialization（[chenmingbiao](https://github.com/chenmingbiao)）
- Automatic Reference Counting（[Channe](https://github.com/Channe)）
- Optional Chaining（[lyojo](https://github.com/lyojo)）
- Error Handling（[lyojo](https://github.com/lyojo)）
- Type Casting（[yangsiy](https://github.com/yangsiy)）
- Nested Types（[SergioChan](https://github.com/SergioChan)）
- Extensions（[shanksyang](https://github.com/shanksyang)）
- Protocols（[futantan](https://github.com/futantan)）
- Generics（[SergioChan](https://github.com/SergioChan)）
- Access Control（[mmoaay](https://github.com/mmoaay)）
- Advanced Operators（[buginux](https://github.com/buginux)）
- About the Language Reference（[KYawn](https://github.com/KYawn)）
- Lexical Structure（[buginux](https://github.com/buginux)）
- Types（[EudeMorgen](https://github.com/EudeMorgen)）
- Expressions（[EudeMorgen](https://github.com/EudeMorgen)）
- Statements（[littledogboy](https://github.com/littledogboy)）
- Declarations（[Lenhoon](https://github.com/Lenhoon)）
- Attributes（[KYawn](https://github.com/KYawn)）
- Patterns（[ray16897188](https://github.com/ray16897188)）
- Generic Parameters and Arguments（[wardenNScaiyi](https://github.com/wardenNScaiyi)）
- Summary of the Grammar（[miaosiqi](https://github.com/miaosiqi)）

# 1.0 译者记录

* 欢迎使用 Swift
   * 关于 Swift ([numbbbbb])
   * Swift 初见 ([numbbbbb])
* Swift 教程
   * 基础部分 ([numbbbbb], [lyuka], [JaySurplus])
   * 基本操作符 ([xielingwang])
   * 字符串和字符 ([wh1100717])
   * 集合类型 ([zqp])
   * 控制流 ([vclwei], [coverxit], [NicePiao])
   * 函数 ([honghaoz])
   * 闭包 ([wh1100717])
   * 枚举 ([yankuangshi])
   * 类和结构体 ([JaySurplus])
   * 属性 ([shinyzhu])
   * 方法 ([pp-prog])
   * 下标 ([siemenliu])
   * 继承 ([Hawstein])
   * 构造过程 ([lifedim])
   * 析构过程 ([bruce0505])
   * 自动引用计数 ([TimothyYe])
   * 可选链 ([Jasonbroker])
   * 类型检查 ([xiehurricane])
   * 嵌套类型 ([Lin-H])
   * 扩展 ([lyuka])
   * 协议 ([geek5nan])
   * 泛型 ([takalard])
   * 高级操作符 ([xielingwang])
* 语言参考
   * 关于语言参考 ([dabing1022])
   * 词法结构 ([superkam])
   * 类型 ([lyuka])
   * 表达式 ([sg552] )
   * 语句 ([coverxit])
   * 声明 ([marsprince])
   * 特性 ([Hawstein])
   * 模式 ([honghaoz])
   * 泛型参数 ([fd5788])
   * 语法总结 ([StanZhai])

# 贡献力量

如果想做出贡献的话，你可以：

- 帮忙校对，挑错别字、病句等等
- 提出修改建议
- 提出术语翻译建议

# 翻译建议

如果你愿意一起校对的话，请仔细阅读：

- 使用markdown进行翻译，文件名必须使用英文，因为中文的话gitbook编译的时候会出问题
- 翻译后的文档请放到source文件夹下的对应章节中，然后pull request即可，我会用gitbook编译成网页
- 工作分支为gh-pages，用于GitHub的pages服务
- fork过去之后新建一个分支进行翻译，完成后pull request这个分支，没问题的话我会合并到gh-pages分支中
- 有其他任何问题都欢迎发issue，我看到了会尽快回复

谢谢！

# 关于术语

翻译术语的时候请参考这个流程：

- 尽量保证和已翻译的内容一致
- 尽量先搜索，一般来说编程语言的大部分术语是一样的，可以参考[微软官方术语搜索](http://www.microsoft.com/Language/zh-cn/Search.aspx)
- 如果以上两条都没有找到合适的结果，请自己决定一个合适的翻译或者直接使用英文原文，后期校对的时候会进行统一

# 参考流程

有些朋友可能不太清楚如何帮忙翻译，我这里写一个简单的流程，大家可以参考一下：

1. 首先fork我的项目
2. 把fork过去的项目也就是你的项目clone到你的本地
3. 在命令行运行 `git branch develop` 来创建一个新分支
4. 运行 `git checkout develop` 来切换到新分支
5. 运行 `git remote add upstream https://github.com/numbbbbb/the-swift-programming-language-in-chinese.git` 把我的库添加为远端库
6. 运行 `git remote update`更新
7. 运行 `git fetch upstream gh-pages` 拉取我的库的更新到本地
8. 运行 `git rebase upstream/gh-pages` 将我的更新合并到你的分支

这是一个初始化流程，只需要做一遍就行，之后请一直在develop分支进行修改。

如果修改过程中我的库有了更新，请重复6、7、8步。

修改之后，首先push到你的库，然后登录GitHub，在你的库的首页可以看到一个 `pull request` 按钮，点击它，填写一些说明信息，然后提交即可。


# 开源协议
基于[WTFPL](http://en.wikipedia.org/wiki/WTFPL)协议开源。



[numbbbbb]:https://github.com/numbbbbb
[stanzhai]:https://github.com/stanzhai
[coverxit]:https://github.com/coverxit
[wh1100717]:https://github.com/wh1100717
[TimothyYe]:https://github.com/TimothyYe
[honghaoz]:https://github.com/honghaoz
[lyuka]:https://github.com/lyuka
[JaySurplus]:https://github.com/JaySurplus
[Hawstein]:https://github.com/Hawstein
[geek5nan]:https://github.com/geek5nan
[yankuangshi]:https://github.com/yankuangshi
[xielingwang]:https://github.com/xielingwang
[yulingtianxia]:https://github.com/yulingtianxia
[twlkyao]:https://github.com/twlkyao
[dabing1022]:https://github.com/dabing1022
[vclwei]:https://github.com/vclwei
[fd5788]:https://github.com/fd5788
[siemenliu]:https://github.com/siemenliu
[youkugems]:https://github.com/youkugems
[haolloyin]:https://github.com/haolloyin
[wxstars]:https://github.com/wxstars
[IceskYsl]:https://github.com/IceskYsl
[sg552]:https://github.com/sg552
[superkam]:https://github.com/superkam
[zac1st1k]:https://github.com/zac1st1k
[bzsy]:https://github.com/bzsy
[pyanfield]:https://github.com/pyanfield
[ericzyh]:https://github.com/ericzyh
[peiyucn]:https://github.com/peiyucn
[sunfiled]:https://github.com/sunfiled
[lzw120]:https://github.com/lzw120
[viztor]:https://github.com/viztor
[wongzigii]:https://github.com/wongzigii
[umcsdon]:https://github.com/umcsdon
[zq54zquan]:https://github.com/zq54zquan
[xiehurricane]:https://github.com/xiehurricane
[Jasonbroker]:https://github.com/Jasonbroker
[tualatrix]:https://github.com/tualatrix
[pp-prog]:https://github.com/pp-prog
[088haizi]:https://github.com/088haizi
[baocaixiong]:https://github.com/baocaixiong
[yeahdongcn]:https://github.com/yeahdongcn
[shinyzhu]:https://github.com/shinyzhu
[lslxdx]:https://github.com/lslxdx
[Evilcome]:https://github.com/Evilcome
[zqp]:https://github.com/zqp
[NicePiao]:https://github.com/NicePiao
[LunaticM]:https://github.com/LunaticM
[menlongsheng]:https://github.com/menlongsheng
[lifedim]:https://github.com/lifedim
[happyming]:https://github.com/happyming
[bruce0505]:https://github.com/bruce0505
[Lin-H]:https://github.com/Lin-H
[takalard]:https://github.com/takalard
[dabing1022]:https://github.com/dabing1022
[marsprince]:https://github.com/marsprince