如果一个开源项目派生出另外的项目,通常意味着项目的分裂和开发团队的削弱,而GitHub中的项目派生则不会,而且正好相反,GitHub中的项目派生是项目壮大的体现。所有的派生项目都会有链接指向原始项目,派生项目没有独立的缺陷追踪系统(ISSUE),而是必须利用创建者本人的项目中的缺陷追踪系统。至于在派生项目中创建的提交,可以非常方便地利用GitHub的Pull Request工具向原始项目的维护者发送Pull Request。
版本库派生
下面就以用户gotgithub身份,访问版本库 https://github.com/gotgit/gotgit/ ,添加新的勘误。
点击项目名称右侧的Fork按钮,便在gotgithub用户自己的托管空间下创建项目派生. 访问派生后的版本库,会发现和派生前的几乎相同,除了没有缺陷跟踪(ISSUE)
现在gotgithub用户就在本地派生的版本库中提交。
- 克隆 gotgithub/gotgit 版本库。
$ git clone git@github.com:gotgithub/gotgit.git
$ cd gotgit
- 编辑文件。
$ vi README.md
$ git diff
- 提交修改
$ git add -u
$ git commit -m "Fixed #3: should be 项目, not 项."
- 推送提交到GitHub。
$ git push
访问GitHub上的派生项目页面,会看到在master分支创建的提交。
Pull Request
那么如何能够让gotgit原始项目的创建者知道这个派生项目及新的提交呢?GitHub提供的工具就是“Pull Request”
点击New pull request按钮进入Pull Request创建界面。在弹出的Pull Request创建界面中查看所包含的提交. 点击“Create pull request”,填写Pull Request的标题和内容,完成Pull Request的创建。
当Pull Request发出后,项目gotgit的开发者会收到通知邮件. 点击邮件中的URL链接,以项目gotgit的开发者(如ossxp-com)身份登录, 可以向Pull Request追加评论,或者关闭此Pull Request。GitHub如果检测到Pull Request中包含的提交可以直接合并,会显示自动合并的提示信息,点击“Confirm Merge”按钮即完成Pull Request中所含提交的自动合并。自动合并完成后,Pull Request页面下方会以评论的形式出现相关提示,并自动关闭Pull Request
手工合并
下面就演示一下当收到他人的Pull Request后,该如何手动合并。实际上在很多情况下,Pull Request所含提交有可能造成合并冲突,那样的话GitHub不再、也不能提供自动合并功能,就必须采用手工合并的方式。
- 将Pull Request发出者的派生版本库添加为一个新的源。
例如收到来自gotgithub用户的Pull Request,不妨以gotgithub为名添加新的源。
$ git remote add gotgithub https://github.com/gotgithub/gotgit.git
- 此时版本库中有两个源,一个克隆时自动建立的origin,另外一个就是新增加的gotgithub。
$ git remote -v
gotgithub https://github.com/gotgithub/gotgit.git (fetch)
gotgithub https://github.com/gotgithub/gotgit.git (push)
origin git@github.com:gotgit/gotgit.git (fetch)
origin git@github.com:gotgit/gotgit.git (push)
- 获取远程版本库gotgithub的分支和提交。
$ git fetch gotgithub
From https://github.com/gotgithub/gotgit
* [new branch] gh-pages -> gotgithub/gh-pages
* [new branch] master -> gotgithub/master
- 现在除了本地分支master外,还有若干远程分支,如下:
$ git branch -a
* master
remotes/gotgithub/gh-pages
remotes/gotgithub/master
remotes/origin/HEAD -> origin/master
remotes/origin/gh-pages
remotes/origin/master
- 将远程分支remotes/gotgithub/master(可简写为gotgithub/master)合并到当前分支中。
$ git merge gotgithub/master
Updating 00c6c4b..7ecdfe7
Fast-forward
errata.mkd | 1 +
1 files changed, 1 insertions(+), 0 deletions(-)
- 查看提交说明,看到此次合并没有产生不必要的合并提交。
$ git log --graph -2
* commit 7ecdfe7451412cfb2e65bb47c12cf2162e21c841
| Author: Wang Sheng wangsheng@ossxp.com
| Date: Tue Aug 16 10:17:53 2011 +0800
|
| Fixed #3: should be 项目, not 项.
|
* commit 00c6c4bfab9824bd967440902ce87440f9e87852
| Author: Jiang Xin worldhello.net@gmail.com
| Date: Wed Aug 3 11:50:31 2011 +0800
|
| Change font color for stronger text from red to brown.
- 将合并推送到GitHub版本库中。
$ git push