hylong / the-swift-programming-language-in-chinese

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

Home Page:http://numbbbbb.github.io/the-swift-programming-language-in-chinese/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

《The Swift Programming Language》in Chinese

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

在线阅读

使用Gitbook制作,可以直接在线阅读

翻译进度

说明:翻译中表示只完成了一部分,你可以接着翻译剩下的部分。不过要及时pr,避免两个人重复翻译同一部分。

  • 欢迎使用 Swift
    • 关于 Swift(完成)
    • Swift 初见(完成)
  • Swift 教程
    • 基础部分(翻译中)
    • 基本操作符
    • 字符串和字符(完成)
    • 集合类型
    • 控制流
    • 函数(翻译中)
    • 闭包
    • 枚举
    • 类和结构体
    • 属性
    • 方法
    • 下标
    • 继承
    • 构造函数
    • 析构函数
    • 自动引用计数
    • 可选链
    • 类型检查
    • 嵌套类型
    • 扩展
    • 接口
    • 泛型
    • 高级操作符
  • 语言参考
    • 关于语言参考
    • 词法结构
    • 类型
    • 表达式
    • 声明
    • 属性
    • 模式
    • 泛型参数
    • 语法总结

更新频率

由于我是利用业余时间翻译,所以速度有限。

不过我会保证每天至少1小时的翻译时间。

贡献力量

如果想做出贡献的话,你可以:

  • 帮忙一起翻译
  • 帮忙校对,挑错别字、病句等等
  • 提出修改建议
  • 提出术语翻译建议

翻译建议

如果你愿意一起翻译的话,请仔细阅读:

  • 使用markdown进行翻译,文件名必须使用英文,因为中文的话gitbook编译的时候会出问题
  • 翻译后的文档请放到source文件夹下的对应章节中,然后pull request即可,我会用gitbook编译成网页
  • 工作分支为gh-pages,用于GitHub的pages服务
  • fork过去之后新建一个分支进行翻译,完成后pull request这个分支,没问题的话我会合并到gh-pages分支中
  • 有其他任何问题都欢迎发issue,我看到了会尽快回复
  • 尽早pull request,你不必翻译完整篇文章再pr,完全可以翻译完一段就pr一次,这样别的朋友可以及时看到你的进度,避免多人翻译同一段。此外,尽早pr也可以让校对的朋友们更早看到新内容,更快发现问题
  • 一定要记得先查看当前的pr再开始翻译,防止重复翻译
  • 我已经提前把所有章节的markdown文件都创建好了,翻译的时候直接写入对应文件即可

谢谢!

关于术语

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

  • 尽量保证和已翻译的内容一致
  • 尽量先搜索,一般来说编程语言的大部分术语是一样的,可以参考微软官方术语搜索
  • 如果以上两条都没有找到合适的结果,请自己决定一个合适的翻译或者直接使用英文原文,后期校对的时候会进行统一

参考流程

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

  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 fetch upstream gh-pages 拉取我的库的更新到本地
  7. 运行 git rebase upstream/gh-pages 将我的更新合并到你的分支

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

如果翻译过程中我的库有了更新,请重复6、7步。

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

开源协议

基于WTFPL协议开源。

About

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

http://numbbbbb.github.io/the-swift-programming-language-in-chinese/