Skip to content

Commit 6f0bbaa

Browse files
committed
Add explicit hyperlink targets for each sections.
1 parent 0db7370 commit 6f0bbaa

38 files changed

+200
-0
lines changed

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _what-is-github:
2+
13
什么是GitHub
24
================
35
GitHub(网址 https://github.com/\ )是一个面向开源及私有软件项目的托管平台,\
@@ -21,6 +23,8 @@ GitHub于2008年4月10日正式发布\ [#]_\ ,相比始于1999年的SourceForg
2123
可以向保存源代码的版本库提交,即对源代码的修改具有最终的决定权。另外一类称为\
2224
贡献者,他们不属于核心开发团队,虽然也能看到源代码,但只可读不可写。
2325

26+
.. _cvcs-model:
27+
2428
采用传统的集中式版本控制系统(如SVN)的开源项目,这两个群体的用户体验都不是\
2529
太好。如图1-2所示,项目的贡献者(非核心成员)很不“高兴”,因为他们即便有修改\
2630
源代码的能力和渴望,也不能直接向版本库提交,要想成为提交者需要一个很长的建立\
@@ -33,6 +37,8 @@ GitHub于2008年4月10日正式发布\ [#]_\ ,相比始于1999年的SourceForg
3337

3438
图1-2:使用集中式版本控制系统
3539

40+
.. _dvcs-model:
41+
3642
Git等分布式版本控制系统的出现,彻底颠覆了原有代码管理的管理模式。使用Git,\
3743
不再需要唯一的、集中式的版本库,而是每个开发者本地都拥有一份完整的版本库。\
3844
Git并不排斥集中式的使用模式,但更倾向于将集中式版本库称为共享版本库。核心\
@@ -55,6 +61,8 @@ Git并不排斥集中式的使用模式,但更倾向于将集中式版本库
5561
通过邮件创建一个拉拽请求(Pull Request),让核心团队的开发者到自己的版本库来\
5662
抓取(Pull)。
5763

64+
.. _github-model:
65+
5866
GitHub的出现极大地改善了开源项目的生态环境,无论是项目的核心开发团队,还是\
5967
普通的项目贡献者都工作得非常“愉快”。创建项目变得非常轻松,创建者只需在GitHub\
6068
上点击一下鼠标即可创建一个新版本库,组建项目核心团队也很容易。核心团队使用\

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _github-hightlights:
2+
13
GitHub亮点
24
===============
35

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _explore-github:
2+
13
探索GitHub
24
===============
35

@@ -50,10 +52,14 @@ GitHub通过屏幕截图等方式介绍了GitHub的常见功能,可以通过
5052

5153
图1-9:GitHub功能介绍
5254

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

61+
.. _octocat:
62+
5763
.. figure:: /images/explore-github/blog.png
5864
:scale: 100
5965

01-explore-github/index.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _github-overview:
2+
13
探索GitHub
24
********************
35
熟悉Git\ [#]_\ 的人几乎都知道并喜欢GitHub\ [#]_\ ,反过来GitHub也吸引更多的\

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _github-signup:
2+
13
创建GitHub账号
24
===============
35

@@ -64,6 +66,8 @@ GitHub对开源软件的300MB托管空间限制并非硬性限制,可以申请
6466

6567
图2-5:账户管理
6668

69+
.. _api-token:
70+
6771
其中API Token是和用户口令相关的密钥,当用户口令更改时API Token也随之更改。\
6872
GitHub的某些应用会使用API Token进行身份认证,从而避免直接使用用户口令造成\
6973
泄露的风险。API Token若泄露的危害要远远小于口令泄露,这因为API Token不能用于\
@@ -79,6 +83,8 @@ API Token。
7983

8084
图2-6:邮件地址管理
8185

86+
.. _ssh:
87+
8288
GitHub为托管的Git版本库提供SSH协议支持,即用户可以用公钥认证的方式连接到\
8389
GitHub的SSH服务器。下面的示例用ssh命令连接github.com的SSH服务,登录用户名为\
8490
git(所有GitHub用户共享此SSH用户名,不要写成其他)。

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _browse-repo:
2+
13
浏览托管项目
24
===============
35

@@ -105,6 +107,8 @@ https://github.com/gotgit/gotgit/\ 。\
105107
在文本文件的差异比较中,不但将有差异的行标识出来,还将行内具体改动的字词用\
106108
特殊颜色进行了标识,不由得感叹GitHub的细致入微。
107109

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

02-join-github/030-be-social.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _soc:
2+
13
社交网络
24
===============
35

02-join-github/index.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _join-github:
2+
13
加入GitHub
24
********************
35
本章介绍如何在GitHub上注册账号,并以现有项目为例介绍GitHub的主要功能。

03-project-hosting/010-new-project.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
1+
.. _new-project:
2+
13
创建新项目
24
===============
35

6+
.. _new-repo:
7+
48
新版本库即是新项目
59
----------------------
610

@@ -40,6 +44,8 @@ URL访问此公开版本库,但只有版本库建立者\ `gotgithub`\ 具有
4044
4145
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access.
4246

47+
.. _init-by-clone:
48+
4349
版本库初始化
4450
--------------
4551

@@ -121,6 +127,8 @@ URL访问此公开版本库,但只有版本库建立者\ `gotgithub`\ 具有
121127

122128
图3-5:完成推送后的项目首页下半部分
123129

130+
.. _init-by-push:
131+
124132
从已有版本库创建
125133
-----------------
126134

03-project-hosting/020-repo-operation.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
1+
.. _git-operations:
2+
13
操作版本库
24
===============
35

6+
.. _noff-push:
7+
48
强制推送
59
----------
610

@@ -93,6 +97,8 @@ ossxp-com的用户,这是因为GitHub是通过提交中的邮件地址来对
9397

9498
图3-7:强制更新后,提交者已更改
9599

100+
.. _new-branch:
101+
96102
新建分支
97103
---------
98104

@@ -143,6 +149,8 @@ ossxp-com的用户,这是因为GitHub是通过提交中的邮件地址来对
143149

144150
图3-8:版本库新增了一个分支
145151

152+
.. _default-branch:
153+
146154
设置默认分支
147155
---------------
148156

@@ -190,6 +198,8 @@ ossxp-com的用户,这是因为GitHub是通过提交中的邮件地址来对
190198
e1e52d99fa71fd6f606903efa9da04fd0055fca9 refs/heads/master
191199
f46a28484adb6c1b4830eb4df582325c740e9d6c refs/heads/mybranch1
192200

201+
.. _del-branch:
202+
193203
删除分支
194204
---------------
195205

@@ -258,6 +268,8 @@ ossxp-com的用户,这是因为GitHub是通过提交中的邮件地址来对
258268
e1e52d99fa71fd6f606903efa9da04fd0055fca9 HEAD
259269
e1e52d99fa71fd6f606903efa9da04fd0055fca9 refs/heads/master
260270

271+
.. _git-tags:
272+
261273
里程碑管理
262274
------------
263275

0 commit comments

Comments
 (0)