Skip to content

Commit 8a95fcf

Browse files
jiangxinjiangxin
committed
Remove spaces around inline markup, using \+space marker.
1 parent 6fc0300 commit 8a95fcf

27 files changed

Lines changed: 242 additions & 242 deletions

‎01-explore-github/010-what-is-github.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33

44
GitHub（网址 https://github.com/ ）是一个面向开源及私有软件项目的托管平台，因为只支持Git作为唯一的版本库格式进行托管，故名GitHub。
55

6-
GitHub的注册用户已经超过百万 [#]_ ，托管的版本库数量已超三百万，其中不乏知名的开源项目，如：Ruby on Rails [#]_ 、Hibernate [#]_ 、phpBB [#]_ 、jQuery [#]_ 、Prototype [#]_ 、Homebrew [#]_ 等。
6+
GitHub的注册用户已经超过百万\ [#]_\ ，托管的版本库数量已超三百万，其中不乏知名的开源项目，如：Ruby on Rails\ [#]_\ 、Hibernate\ [#]_\ 、phpBB\ [#]_\ 、jQuery\ [#]_\ 、Prototype\ [#]_\ 、Homebrew\ [#]_\ 等。
77

8-
GitHub于2008年4月10日正式发布 [#]_ ，相比始于1999年的SourceForge [#]_ 和2005年的GoogleCode [#]_ ，GitHub后来者居上。以2011年的数据从代码提交数量上看，GitHub已经超越其前辈 [#]_ ，如图1-1所示。
8+
GitHub于2008年4月10日正式发布\ [#]_\ ，相比始于1999年的SourceForge\ [#]_\ 和2005年的GoogleCode\ [#]_\ ，GitHub后来者居上。以2011年的数据从代码提交数量上看，GitHub已经超越其前辈\ [#]_\ ，如图1-1所示。
99

1010
.. figure:: /images/explore-github/survival-of-the-forges.png
1111
:scale: 100
@@ -28,7 +28,7 @@ Git等分布式版本控制系统的出现，彻底颠覆了原有代码管理
2828

2929
图1-3：使用分布式版本控制系统
3030

31-
使用Git做版本控制（如图1-3所示），核心开发团队非常“高兴”，因为他们和共享版本库之间不必一直保持连接状态，诸如查看日志、提交、创建分支等几乎全部操作都（脱离网络）在本地的版本库中完成。项目贡献者（非核心成员）也不再那么沮丧，因为版本库人人皆可更改（当然是对本地版本库而言）。稍微让贡献者感到困难的就是如何将自己对项目的改进被核心开发团队所了解并接纳。Git提供了多种途径，一个方法是先用 ``git format-patch`` 命令将本地提交转换为补丁文件或补丁文件序列，再通过邮件发送给核心开发团队。另外一个办法就是搭建一个自己专有的共享版本库，通过邮件创建一个拉拽请求（Pull Request），让核心团队的开发者到自己的版本库来抓取（Pull）。
31+
使用Git做版本控制（如图1-3所示），核心开发团队非常“高兴”，因为他们和共享版本库之间不必一直保持连接状态，诸如查看日志、提交、创建分支等几乎全部操作都（脱离网络）在本地的版本库中完成。项目贡献者（非核心成员）也不再那么沮丧，因为版本库人人皆可更改（当然是对本地版本库而言）。稍微让贡献者感到困难的就是如何将自己对项目的改进被核心开发团队所了解并接纳。Git提供了多种途径，一个方法是先用\ ``git format-patch``\ 命令将本地提交转换为补丁文件或补丁文件序列，再通过邮件发送给核心开发团队。另外一个办法就是搭建一个自己专有的共享版本库，通过邮件创建一个拉拽请求（Pull Request），让核心团队的开发者到自己的版本库来抓取（Pull）。
3232

3333
GitHub的出现极大地改善了开源项目的生态环境，无论是项目的核心开发团队，还是普通的项目贡献者都工作得非常“愉快”。创建项目变得非常轻松，创建者只需在GitHub上点击一下鼠标即可创建一个新版本库，组建项目核心团队也很容易。核心团队使用Git命令操作共享版本库，如图1-4所示。
3434

‎01-explore-github/020-github-hightlights.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ GitHub亮点
1111

1212
2. 对Git的完整支持。
1313

14-
相比其他开源项目托管平台，GitHub对Git版本库提供了完整的协议支持，支持HTTP智能协议、Git-daemon、SSH协议。相比只支持HTTP协议的GoogleCode，GitHub通过SSH协议可以实现版本库访问的无口令认证 [#]_ 。
14+
相比其他开源项目托管平台，GitHub对Git版本库提供了完整的协议支持，支持HTTP智能协议、Git-daemon、SSH协议。相比只支持HTTP协议的GoogleCode，GitHub通过SSH协议可以实现版本库访问的无口令认证\ [#]_\ 。
1515

1616
3. 无处不在的Git。
1717

18-
除了在版本库托管上使用Git，Git还被应用到GitHub更多的领域。维基使用Git，可以通过克隆维基所在的版本库，离线修改维基；在线粘贴数据的Gist网站 [#]_ 使用Git，记录变更历史；以及在Jekyll应用的帮助下，用Git版本库维护个人网站和博客等。
18+
除了在版本库托管上使用Git，Git还被应用到GitHub更多的领域。维基使用Git，可以通过克隆维基所在的版本库，离线修改维基；在线粘贴数据的Gist网站\ [#]_\ 使用Git，记录变更历史；以及在Jekyll应用的帮助下，用Git版本库维护个人网站和博客等。
1919

2020
4. 在线编辑文件。
2121

@@ -35,5 +35,5 @@ GitHub亮点
3535

3636
----
3737

38-
.. [#] 实际上使用HTTP协议也可以免口令输入。即通过文件 ``~/.netrc`` 写入HTTP认证的明文口令，具体文件格式参见 ``ftp`` 命令的MAN手册中相关介绍。
38+
.. [#] 实际上使用HTTP协议也可以免口令输入。即通过文件\ ``~/.netrc``\ 写入HTTP认证的明文口令，具体文件格式参见\ ``ftp``\ 命令的MAN手册中相关介绍。
3939
.. [#] https://gist.github.com/

‎01-explore-github/030-explore-github.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
探索GitHub
22
===============
33

4-
打开浏览器，访问网址 https://github.com/ 来探索GitHub吧。GitHub的首页（图1-5所示）特意给出了Git和GitHub的音标，可能不少国人需要据此校准一下Git的读音 [#]_ 。
4+
打开浏览器，访问网址 https://github.com/ 来探索GitHub吧。GitHub的首页（图1-5所示）特意给出了Git和GitHub的音标，可能不少国人需要据此校准一下Git的读音\ [#]_\ 。
55

66
.. figure:: /images/explore-github/github-homepage.png
77
:scale: 100
@@ -41,7 +41,7 @@ GitHub通过屏幕截图等方式介绍了GitHub的常见功能，可以通过
4141

4242
图1-9：GitHub功能介绍
4343

44-
博客也是了解GitHub的一个重要的途径，可以获知GitHub的最新动态，如最新改进等。图1-10显示的是GitHub在感恩节推出的促销活动：收费服务免费试用一个月！ [#]_ 如果及时关注博客就不会错过噢。
44+
博客也是了解GitHub的一个重要的途径，可以获知GitHub的最新动态，如最新改进等。图1-10显示的是GitHub在感恩节推出的促销活动：收费服务免费试用一个月！\ [#]_\ 如果及时关注博客就不会错过噢。
4545

4646
.. figure:: /images/explore-github/blog.png
4747
:scale: 100

‎01-explore-github/index.rst‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
探索GitHub
22
********************
3-
熟悉Git [#]_ 的人几乎都知道并喜欢GitHub [#]_ ，反过来GitHub也吸引更多的人来使用Git。GitHub正在成为开源项目托管的主要平台，是什么成就了GitHub？
3+
熟悉Git\ [#]_\ 的人几乎都知道并喜欢GitHub\ [#]_\ ，反过来GitHub也吸引更多的人来使用Git。GitHub正在成为开源项目托管的主要平台，是什么成就了GitHub？
44

55
.. toctree::
66
:maxdepth: 1
@@ -12,8 +12,8 @@
1212
.. seealso::
1313

1414
本书并非一本介绍Git的书，并且假设读者已经掌握了Git的相关操作。
15-
如果读者对Git尚不了解，可以参考我写的 《Git权威指南》 [#]_ 一书。此外还可以从网上找到很多免费的、很好的Git资料，
16-
如：Git社区书 [#]_ 、Pro Git [#]_ 等。
15+
如果读者对Git尚不了解，可以参考我写的 《Git权威指南》\ [#]_\ 一书。此外还可以从网上找到很多免费的、很好的Git资料，
16+
如：Git社区书\ [#]_\ 、Pro Git\ [#]_\ 等。
1717

1818
----
1919

‎02-join-github/010-account-setup.rst‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,21 +71,21 @@ GitHub为托管的Git版本库提供SSH协议支持，即用户可以用公钥
7171

7272
要想向GitHub添加SSH公钥，首先要确保正确生成了对应的公钥/私钥对。关于SSH公钥认证，在我的《Git权威指南》一书的“第29章使用SSH协议”中有详细介绍，这里仅做简要的介绍。
7373

74-
GitHub的SSH服务支持OpenSSH格式的公钥认证，可以通过Linux、Mac OS X、或Cygwin下的 ``ssh-keygen`` 命令创建公钥/私钥对。命令如下：
74+
GitHub的SSH服务支持OpenSSH格式的公钥认证，可以通过Linux、Mac OS X、或Cygwin下的\ ``ssh-keygen``\ 命令创建公钥/私钥对。命令如下：
7575

7676
::
7777

7878
$ ssh-keygen
7979

80-
然后根据提示在用户主目录下的 ``.ssh`` 目录中创建默认的公钥/私钥对文件，其中 ``~/.ssh/id_rsa`` 是私钥文件， ``~/.ssh/id_rsa.pub`` 是公钥文件。注意私钥文件要严加保护，不能泄露给任何人。如果在执行 ``ssh-keygen`` 命令时选择了使用口令保护私钥，私钥文件是经过加密的。至于公钥文件 ``~/.ssh/id_rsa.pub`` 则可以放心地公开给他人。
80+
然后根据提示在用户主目录下的\ ``.ssh``\ 目录中创建默认的公钥/私钥对文件，其中\ ``~/.ssh/id_rsa``\ 是私钥文件，\ ``~/.ssh/id_rsa.pub``\ 是公钥文件。注意私钥文件要严加保护，不能泄露给任何人。如果在执行\ ``ssh-keygen``\ 命令时选择了使用口令保护私钥，私钥文件是经过加密的。至于公钥文件\ ``~/.ssh/id_rsa.pub``\ 则可以放心地公开给他人。
8181

82-
也可以用 ``ssh-keygen`` 命令以不同的名称创建多个公钥，当拥有多个GitHub账号时，非常重要。这是因为虽然一个GitHub账号允许使用多个不同的SSH公钥，但反过来，一个SSH公钥只能对应于一个GitHub账号。下面的命令在 ``~/.ssh`` 目录下创建名为 ``gotgithub`` 的私钥和名为 ``gotgithub.pub`` 的公钥文件。
82+
也可以用\ ``ssh-keygen``\ 命令以不同的名称创建多个公钥，当拥有多个GitHub账号时，非常重要。这是因为虽然一个GitHub账号允许使用多个不同的SSH公钥，但反过来，一个SSH公钥只能对应于一个GitHub账号。下面的命令在\ ``~/.ssh``\ 目录下创建名为\ ``gotgithub``\ 的私钥和名为\ ``gotgithub.pub``\ 的公钥文件。
8383

8484
::
8585

8686
$ ssh-keygen -C "[email protected]" -f ~/.ssh/gotgithub
8787

88-
当生成的公钥/私钥对不在缺省位置（~/.ssh/id_rsa等）时，使用 ``ssh`` 命令连接远程主机时需要使用参数 ``-i <filename>`` 指定公钥/私钥对。或者在配置文件 ``~/.ssh/config`` 中针对相应主机进行设定。例如对于上例创建了非缺省公钥/私钥对 ``~/.ssh/gotgithub`` ，可以在 ``~/.ssh/config`` 配置文件中写入如下配置。
88+
当生成的公钥/私钥对不在缺省位置（~/.ssh/id_rsa等）时，使用\ ``ssh``\ 命令连接远程主机时需要使用参数\ ``-i <filename>``\ 指定公钥/私钥对。或者在配置文件\ ``~/.ssh/config``\ 中针对相应主机进行设定。例如对于上例创建了非缺省公钥/私钥对\ ``~/.ssh/gotgithub``\ ，可以在\ ``~/.ssh/config``\ 配置文件中写入如下配置。
8989

9090
::
9191

@@ -109,14 +109,14 @@ GitHub的SSH服务支持OpenSSH格式的公钥认证，可以通过Linux、Mac O
109109

110110
图2-8：添加SSH公钥认证
111111

112-
设置成功后，再用 ``ssh`` 命令访问 github.com，会显示一条认证成功信息并退出。在认证成功的信息中还会显示该公钥对应的用户名。
112+
设置成功后，再用\ ``ssh``\ 命令访问 github.com，会显示一条认证成功信息并退出。在认证成功的信息中还会显示该公钥对应的用户名。
113113

114114
::
115115

116116
$ ssh -T [email protected]
117117
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access.
118118

119-
如果您未能看到类似的成功信息，可以通过在 ``ssh`` 命令后面添加 ``-v`` 参数加以诊断，会在冗长的会话中看到认证所使用的公钥文件等信息。
119+
如果您未能看到类似的成功信息，可以通过在\ ``ssh``\ 命令后面添加\ ``-v``\ 参数加以诊断，会在冗长的会话中看到认证所使用的公钥文件等信息。
120120

121121
::
122122

‎02-join-github/020-browse-repo.rst‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@ GitHub的账户已经建立好了，在建立自己的项目托管之前，看
55

66
* 区域一：项目概要介绍及版本库URL等。
77

8-
项目GotGit托管在组织账号 gotgit 之下 [#]_ ，并且已经有若干关注用户和派生项目。最下面一行显示版本库的访问地址，只显示了HTTP和Git-daemon两个协议的URL地址，这是因为当前用户对该版本库只具有只读权限，因此没有显示SSH协议的URL地址。
8+
项目GotGit托管在组织账号 gotgit 之下\ [#]_\ ，并且已经有若干关注用户和派生项目。最下面一行显示版本库的访问地址，只显示了HTTP和Git-daemon两个协议的URL地址，这是因为当前用户对该版本库只具有只读权限，因此没有显示SSH协议的URL地址。
99

1010
.. figure:: /images/join-github/gotgit-repo-tree-1.png
1111
:scale: 100
1212

1313
图2-10：版本库概要信息
1414

15-
使用任意一种协议均可克隆该Git版本库，但要注意只有Git 1.6.6及以上版本才支持智能HTTP协议，低版本Git则无法用HTTP协议克隆GitHub上的版本库 [#]_ 。
15+
使用任意一种协议均可克隆该Git版本库，但要注意只有Git 1.6.6及以上版本才支持智能HTTP协议，低版本Git则无法用HTTP协议克隆GitHub上的版本库\ [#]_\ 。
1616

1717
::
1818

@@ -26,7 +26,7 @@ GitHub的账户已经建立好了，在建立自己的项目托管之前，看
2626

2727
* 区域二：代码浏览子菜单及分支切换对话框。
2828

29-
默认项目代码页（即项目首页）显示项目文件列表（即 ``Files`` 子菜单）。在图2-11的右侧还显示了项目 ``gotgit/gotgit`` 默认的分支为 ``gh-pages`` 而非常见的 ``master`` 分支。关于 ``gh-pages`` 分支，在“第3.5节 建立主页”会介绍该分支的神奇用途。
29+
默认项目代码页（即项目首页）显示项目文件列表（即\ ``Files``\ 子菜单）。在图2-11的右侧还显示了项目\ ``gotgit/gotgit``\ 默认的分支为\ ``gh-pages``\ 而非常见的\ ``master``\ 分支。关于\ ``gh-pages``\ 分支，在“第3.5节 建立主页”会介绍该分支的神奇用途。
3030

3131
.. figure:: /images/join-github/gotgit-repo-tree-1-submenu.png
3232
:scale: 100
@@ -47,9 +47,9 @@ GitHub的账户已经建立好了，在建立自己的项目托管之前，看
4747

4848
图2-13：目录树
4949

50-
* 区域五：根目录下的文件 ``README.md`` 格式化为HTML输出。
50+
* 区域五：根目录下的文件\ ``README.md``\ 格式化为HTML输出。
5151

52-
GitHub内置了多种文本标记语言的支持，如Markdown、Textile、reStructuredText、asciidoc、Wiki等。当发现根目录下的 ``README`` 文件后，会根据其扩展名判断所用的标记语言类型，自动转换为HTML格式显示。
52+
GitHub内置了多种文本标记语言的支持，如Markdown、Textile、reStructuredText、asciidoc、Wiki等。当发现根目录下的\ ``README``\ 文件后，会根据其扩展名判断所用的标记语言类型，自动转换为HTML格式显示。
5353

5454
.. figure:: /images/join-github/gotgit-repo-tree-4.png
5555
:scale: 100
@@ -88,7 +88,7 @@ GitHub的账户已经建立好了，在建立自己的项目托管之前，看
8888

8989
在文本文件的差异比较中，不但将有差异的行标识出来，还将行内具体改动的字词用特殊颜色进行了标识，不由得感叹GitHub的细致入微。
9090

91-
GitHub还支持对图形文件的差异比较，并提供四种比较方式。在如下地址: http://git.io/image-diff [#]_ 提供了一个示例提交。您可以去尝试一下不同的图形文件比较方式，以便更直观地观察图形文件前后的改动。
91+
GitHub还支持对图形文件的差异比较，并提供四种比较方式。在如下地址: http://git.io/image-diff\ [#]_\ 提供了一个示例提交。您可以去尝试一下不同的图形文件比较方式，以便更直观地观察图形文件前后的改动。
9292

9393
* 默认修改前后的两幅图片左右并排显示，如图2-19所示。
9494

@@ -106,7 +106,7 @@ GitHub还支持对图形文件的差异比较，并提供四种比较方式。
106106

107107
* 还提供洋葱皮和色差比较，自己动手试试吧。
108108

109-
网络图是GitHub的一大特色，显示一个项目的版本库被不同用户派生（Fork）后，各个版本库的派生关系。这个网络图最早使用Flash实现的，目前已经改为HTML5实现 [#]_ 。图2-21的示例网络图来自于Gitosis项目 [#]_ 。
109+
网络图是GitHub的一大特色，显示一个项目的版本库被不同用户派生（Fork）后，各个版本库的派生关系。这个网络图最早使用Flash实现的，目前已经改为HTML5实现\ [#]_\ 。图2-21的示例网络图来自于Gitosis项目\ [#]_\ 。
110110

111111
.. figure:: /images/join-github/network-graph.png
112112
:scale: 100

0 commit comments

Comments
 (0)