美文网首页
5. Fork 模式

5. Fork 模式

作者: 牛崽儿酷 | 来源:发表于2017-03-23 15:48 被阅读0次

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

    相关文章

      网友评论

          本文标题:5. Fork 模式

          本文链接:https://www.haomeiwen.com/subject/ynoznttx.html