5. Fork 模式

如果一个开源项目派生出另外的项目,通常意味着项目的分裂和开发团队的削弱,而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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 一、青葱岁月畅想 青葱岁月群——伴着激扬的德国战歌走来。时而气势磅礴,时而威风凛凛,时而柔情似水,时而风情万种。 ...
    晓村阅读 614评论 0 0
  • 见你那么匆匆忙忙 我又倍感慌张 仿佛要把世界涂成你的颜色 让世人跟着你的平仄 一日之寒是否会地冻三尺 阳光的温暖又...
    vegout阅读 429评论 0 0
  • 我现在,此时此刻,异常焦虑,本来想搞搞公众号,结果发现,这特么的都是啥,这是啥,这又是啥,这里放什么……公众号怎么...
    想去远方的喵喵酱阅读 221评论 3 2
  • 世界那么美好,生活却有烦恼。生活中的五块九毛八、八块九毛九、两块九毛八有时候会让你喘不气,过着那种活着不如死了的生...
    快读书阅读 250评论 1 0