Merge pull request #259 from networm/sync_06-github

Sync 06-github

Author: networm

book/06-github/1-github.asc

@@ -14,7 +14,8 @@ GitHub 是最大的 Git 版本库托管商，是成千上万的开发者和项
 [WARNING]
 .接口的改变
 ====
-需要注意一点，同很多活跃的网站一样，书中截取的界面会随时间而改变。希望我们试图表达的核心思想一直是不变的，但是，如果你想要这些截图的更新版本，本书的在线版本或许有更新的截图。
+需要注意一点，同很多活跃的网站一样，书中截取的界面会随时间而改变。
+希望我们试图表达的核心思想一直是不变的，但是，如果你想要这些截图的更新版本，本书的在线版本或许有更新的截图。
 ====
 
 include::sections/1-setting-up-account.asc[]

book/06-github/sections/1-setting-up-account.asc

@@ -42,13 +42,15 @@ image::images/ssh-keys.png[``SSH keys''链接。]
 
 [NOTE]
 ====
-确保给你的 SSH 密钥起一个能够记得住的名字。你可以为每一个密钥起名字（例如，“我的笔记本电脑”或者“工作账户”等），以便以后需要吊销密钥时能够方便地区分。
+确保给你的 SSH 密钥起一个能够记得住的名字。
+你可以为每一个密钥起名字（例如，“我的笔记本电脑”或者“工作账户”等），以便以后需要吊销密钥时能够方便地区分。
 ====
 
 [[_personal_avatar]]
 ==== 头像
 
-下一步，如果愿意的话，你可以将生成的头像换成你喜欢的图片。首先，来到``Profile''标签页（在``SSH Keys''标签页上方），点击``Upload new picture''。
+下一步，如果愿意的话，你可以将生成的头像换成你喜欢的图片。
+首先，来到``Profile''标签页（在``SSH Keys''标签页上方），点击``Upload new picture''。
 
 .``Profile''链接。
 image::images/your-profile.png[``Profile''链接。]
@@ -64,17 +66,24 @@ image::images/avatar-crop.png[裁剪已上传的头像。]
 
 ==== 邮件地址
 
-GitHub 使用用户邮件地址区分 Git 提交。如果你在自己的提交中使用了多个邮件地址，希望 GitHub 可以正确地将它们连接起来，你需要在管理页面的 Emails 部分添加你拥有的所有邮箱地址。
+GitHub 使用用户邮件地址区分 Git 提交。
+如果你在自己的提交中使用了多个邮件地址，希望 GitHub 可以正确地将它们连接起来，你需要在管理页面的 Emails 部分添加你拥有的所有邮箱地址。
 
 [[_add_email_addresses]]
 .添加邮件地址
 image::images/email-settings.png[添加所有邮件地址。]
 
-在 <<_add_email_addresses>> 中我们可以看到一些不同的状态。顶部的地址是通过验证的，并且被设置为主要地址，这意味着该地址会接收到所有的通知和回复。第二个地址是通过验证的，如果愿意的话，可以将其设置为主要地址。最后一个地址是未通过验证的，这意味着你不能将其设置为主要地址。当 GitHub 发现任意版本库中的任意提交信息包含了这些地址，它就会将其链接到你的账户。
+在 <<_add_email_addresses>> 中我们可以看到一些不同的状态。
+顶部的地址是通过验证的，并且被设置为主要地址，这意味着该地址会接收到所有的通知和回复。
+第二个地址是通过验证的，如果愿意的话，可以将其设置为主要地址。
+最后一个地址是未通过验证的，这意味着你不能将其设置为主要地址。
+当 GitHub 发现任意版本库中的任意提交信息包含了这些地址，它就会将其链接到你的账户。
 
 ==== 两步验证
 
-最后，为了额外的安全性，你绝对应当设置两步验证，简写为 ``2FA''。两步验证是一种用于降低因你的密码被盗而带来的账户风险的验证机制，现在已经变得越来越流行。开启两步验证，GitHub 会要求你用两种不同的验证方法，这样，即使其中一个被攻破，攻击者也不能访问你的账户。
+最后，为了额外的安全性，你绝对应当设置两步验证，简写为 ``2FA''。
+两步验证是一种用于降低因你的密码被盗而带来的账户风险的验证机制，现在已经变得越来越流行。
+开启两步验证，GitHub 会要求你用两种不同的验证方法，这样，即使其中一个被攻破，攻击者也不能访问你的账户。
 
 你可以在 Account settings 页面的 Security 标签页中找到 Two-factor Authentication 设置。
 

book/06-github/sections/2-contributing.asc

@@ -54,11 +54,14 @@ Tony 在找一些能在他的 Arduino 微控制器上运行的代码，他觉得
 .他想要做出贡献的项目
 image::images/blink-01-start.png[他想要做出贡献的项目]
 
-但是有个问题，这个代码中的的闪烁频率太高，我们觉得 3 秒一次比 1 秒一次更好一些。所以让我们来改进这个程序，并将修改后的代码提交给这个项目。
+但是有个问题，这个代码中的的闪烁频率太高，我们觉得 3 秒一次比 1 秒一次更好一些。
+所以让我们来改进这个程序，并将修改后的代码提交给这个项目。
 
-首先，单击“Fork”按钮来获得这个项目的副本。我们使用的用户名是“tonychacon”，所以这个项目副本的访问地址是： `https://github.com/tonychacon/blink` 。我们将它克隆到本地，创建一个分支，修改代码，最后再将改动推送到 GitHub。
+首先，单击“Fork”按钮来获得这个项目的副本。
+我们使用的用户名是“tonychacon”，所以这个项目副本的访问地址是： `https://github.com/tonychacon/blink` 。
+我们将它克隆到本地，创建一个分支，修改代码，最后再将改动推送到 GitHub。
 
-[source,shell]
+[source,console]
 ----
 $ git clone https://github.com/tonychacon/blink <1>
 Cloning into 'blink'...
@@ -84,7 +87,7 @@ void loop() {
 }
 
 $ git commit -a -m 'three seconds is better' <5>
-[master 5ca509d] three seconds is better
+[slow-blink 5ca509d] three seconds is better
  1 file changed, 2 insertions(+), 2 deletions(-)
 
 $ git push origin slow-blink <6>
@@ -201,7 +204,7 @@ GitHub 上的大多数的开发者会使用后一种方法，基于我们在上
 
 在这个例子中，我们再次使用之前的“tonychacon”用户来进行示范，源作者提交了一个改动，使得合并请求和它产生了冲突。现在来看我们解决这个问题的步骤。
 
-[source,shell]
+[source,console]
 ----
 $ git remote add upstream https://github.com/schacon/blink <1>
 
@@ -242,7 +245,7 @@ To https://github.com/tonychacon/blink
 
 你完成了上面的步骤后，合并请求将会自动更新并重新检查是否能干净的合并。
 
-[[_pr_fail]]
+[[_pr_merge_fix]]
 .合并请求现在可以干净地合并了
 image::images/pr-02-merge-fix.png[修复了的合并请求]
 
@@ -276,7 +279,7 @@ image::images/mentions-02-render.png[渲染后的合并请求中的引用]
 .在合并请求中渲染后的交叉引用
 image::images/mentions-03-closed.png[合并请求关闭]
 
-除了议题编号外，你还可以通过使用提交的 SHA 来引用提交。你必须完整的写出 40 位长的 SHA，GitHub 会在评论中自动地产生指向这个提交的链接。同样的，你可以像引用议题一样对“Fork”出的项目中的提交或者其他项目中的提交进行引用。
+除了议题编号外，你还可以通过使用提交的 SHA-1 来引用提交。你必须完整的写出 40 位长的 SHA，GitHub 会在评论中自动地产生指向这个提交的链接。同样的，你可以像引用议题一样对“Fork”出的项目中的提交或者其他项目中的提交进行引用。
 
 ==== Markdown