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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容

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