4.1. Fork + Pull模式?參與GitHub中的項目開發(fā),，最常用和推薦的首選方式是“Fork + Pull”模式,。在“Fork + Pull”模式下，項目參與者不必向項目創(chuàng)建者申請?zhí)峤粰嘞?，而是在自己的托管空間下建立項目的派生（Fork）,。 如果一個開源項目派生出另外的項目,，通常意味著項目的分裂和開發(fā)團隊的削弱，而GitHub中的項目派生則不會,，而且正好相反,，GitHub中的項目派生是項目壯大的體現(xiàn)。所有的派生項目都會有鏈接指向原始項目,，派生項目沒有獨立的缺陷追蹤系統(tǒng)（ISSUE）,，而是必須利用創(chuàng)建者本人的項目中的缺陷追蹤系統(tǒng)。至于在派生項目中創(chuàng)建的提交,，可以非常方便地利用GitHub的Pull Request工具向原始項目的維護者發(fā)送Pull Request,。 下面以GotGit版本庫為例，介紹如何利用GitHub提供的Fork和Pull Request工具實現(xiàn)工作協(xié)同,。 4.1.1. 版本庫派生?GotGit版本庫[1]用于維護《Git權威指南》一書的官網(wǎng)和勘誤,，下面演示的勘誤表修改是由王勝[2]通過GitHub之外的一個缺陷追蹤平臺報告的[3]。他在報告中,，甚至直接用GNU diff格式告訴我該如何修改,。 下面就以用戶gotgithub身份,，訪問版本庫 https://github.com/gotgit/gotgit/ ,，添加新的勘誤。如圖4-1所示,，gotgit項目在之前的示例中已經(jīng)被我們關注但尚未Fork,。 
圖4-1：原gotgit項目 點擊項目名稱右側的Fork按鈕，便在gotgithub用戶自己的托管空間下創(chuàng)建項目派生,，派生項目版本庫出現(xiàn)在版本庫列表中,，如圖4-2。 
圖4-2：gotgithub用戶的項目列表 訪問派生后的版本庫,，會發(fā)現(xiàn)和派生前的幾乎相同,，除了沒有缺陷跟蹤（ISSUE），以及標識了該項目派生之前的原路徑等,。如圖4-3所示,。 
圖4-3：派生的gotgit項目 現(xiàn)在gotgithub用戶就在本地派生的版本庫中提交。
訪問GitHub上的派生項目頁面,，會看到以用戶whangsheng在master分支[5]創(chuàng)建的提交。如圖4-4所示,。 
圖4-4：派生版本庫中的新提交 4.1.2. Pull Request?那么如何能夠讓gotgit原始項目的創(chuàng)建者知道這個派生項目及新的提交呢,？GitHub提供的工具就是“Pull Request”。注意到圖4-3右上方“Pull Request”按鈕了么,？點擊該按鈕進入Pull Request創(chuàng)建界面,。 在彈出的Pull Request創(chuàng)建界面中，點擊菜單中的“Commits”,，查看所包含的提交,。如圖4-5所示。 
圖4-5：Pull Request包含的提交 點擊菜單中的“Files Changed”,，查看所包含的提交,。如圖4-6所示。 
圖4-6：Pull Request包含的改動差異 點擊菜單中的“Preview Discussion”,，填寫Pull Request的標題和內容,，完成Pull Request的創(chuàng)建。如圖4-7所示,。 
圖4-7：Pull Request的提交界面 當Pull Request發(fā)出后,，項目gotgit的開發(fā)者會收到通知郵件，如圖4-8所示,。 
圖4-8：Pull Request的通知郵件 點擊郵件中的URL鏈接,，以項目gotgit的開發(fā)者（如ossxp-com）身份登錄，看到如圖4-9的視圖,。之所以看到有兩個用戶參與到此Pull Request,，是因為Pull Request創(chuàng)建者和提交的作者是不同的用戶。圖4-9下方的表單可以向Pull Request追加評論,，或者關閉此Pull Request,。 
圖4-9：Pull Request接收者視圖 GitHub如果檢測到Pull Request中包含的提交可以直接合并，會顯示自動合并的提示信息,，點擊圖4-9中提示信息中的自動合并按鈕,，顯示圖4-10的自動合并對話框,。 
圖4-10：Pull Request的通知郵件 點擊“Confirm Merge”按鈕即完成Pull Request中所含提交的自動合并。自動合并完成后,，Pull Request頁面下方會以評論的形式出現(xiàn)相關提示,，并自動關閉Pull Request。如圖4-11所示,。 
圖4-11：Pull Request關閉 4.1.3. 手工合并?Pull Request提供的自動合并顯示在提交日志中是什么樣子的呢,？以用戶ossxp-com身份檢出版本庫，會看到用戶wangsheng的提交已經(jīng)合并到版本庫中,。 $ git clone [email protected]:gotgit/gotgit.git
$ cd gotgit
$ git log --graph -3
* commit 6c1f1ee152629fd2f8d00ebe92c27a32d068d756
|\ Merge: 00c6c4b 7ecdfe7
| | Author: OpenSourceXpress <[email protected]>
| | Date: Tue Aug 16 01:23:47 2011 -0700
| |
| | Merge pull request #4 from gotgithub/master
| |
| | Find a typo in the book
| |
| * commit 7ecdfe7451412cfb2e65bb47c12cf2162e21c841
|/ Author: Wang Sheng <wangsheng@>
| Date: Tue Aug 16 10:17:53 2011 +0800
|
| Fixed #3: should be 項目, not 項.
|
* commit 00c6c4bfab9824bd967440902ce87440f9e87852
| Author: Jiang Xin <[email protected]>
| Date: Wed Aug 3 11:50:31 2011 +0800
|
| Change font color for stronger text from red to brown.
可以看出GitHub的自動合并產生了一個合并提交,，類似執(zhí)行git merge --no-ff命令。也就是說即使用戶wangsheng的提交是一個“快進式提交”（基于gotgit/gotgit版本庫最新提交所做的提交）,，也要產生一個合并提交,。 可能有人并不喜歡這種用--no-ff參數(shù)的非標準的合并方式，因為這種合并產生了一個多余的提交,，可能增加代碼評審的負擔,。若要取消GitHub的自動合并也很簡單，因為Git無所不能： $ git reset --hard HEAD^ # 回退一個提交,，即回退到當前提交的第一個父提交
$ git rev-parse HEAD # 檢查是否正確的回退
00c6c4bfab9824bd967440902ce87440f9e87852
$ git push -f # 強制推送回退的 master 分支
下面就演示一下當收到他人的Pull Request后,，該如何手動合并。實際上在很多情況下,，Pull Request所含提交有可能造成合并沖突,，那樣的話GitHub不再、也不能提供自動合并功能,，就必須采用手工合并的方式。
4.1.4. 在線編輯?GitHub提供了在線編輯功能,，這樣可以無需克隆版本庫,、無需使用Git即可完成對版本庫中文件的修改，甚至可以在你的iPad甚至iPhone上完成對文件的修改,。 以gotgithub賬戶身份登錄GitHub,，訪問之前派生而來的版本庫gotgithub/gotgit中的文件，例如文件errata.md[6],，會看到其中一個“Edit this file”的按鈕,，如圖4-12所示。
圖4-12：瀏覽自己版本庫中文件 點擊圖4-12中的“Edit this file”按鈕,，開始在線編輯文件errata.md,，編輯器還支持語法加亮，如圖4-13所示,。
圖4-13：編輯文件 4.1.5. 簡化的 Fork + Pull Request?到目前,，我們已經(jīng)了解了GitHub的三大武器：Fork、Pull Request和在線編輯,。對于最常用的“Fork + Pull Request”操作,，GitHub還提供了一個快捷模式。即GitHub對于無權更改的他人版本庫中的文件,，提供了一個類似在線編輯的按鈕,，名為“Fork and edit this file”按鈕，自動完成版本庫派生和在線編輯,，即將三大武器一勺燴,。 訪問他人版本庫（尚未在自己空間派生）中的文件，例如訪問下面地址：http:///hello-world-makefile[7],。顯示他人（ossxp-com）版本庫hello-world中的src/Makefile文件,，如圖4-14所示。
圖4-14：瀏覽他人版本庫中文件 點擊圖4-14中的“Fork and edit this file”按鈕,，會自動在自己托管空間創(chuàng)建派生版本庫,，并開始在線編輯文件src/Makefile，如圖4-15所示,。
圖4-15：派生并編輯文件 文件修改完畢,，點擊“Propose File Change”按鈕，會將改動作提交到派生的版本庫中,，并馬上開啟一個新的Pull Request,。如圖4-16所示。
圖4-16：編輯完畢自動開啟Pull Request 點擊“Send pull request”按鈕完成Pull Request的創(chuàng)建,。如果仔細查看圖4-16,，會發(fā)現(xiàn)Pull Request所包含的修改發(fā)生在gotgithub/hello-world派生版本庫中的patch-1分支中，并非通常的master分支,。 原版本庫ossxp-com/hello-world的開發(fā)者會收到一封郵件,，通知有新的Pull Request,，如下所示（前四行為信頭）： From: GotGitHub <[email protected]>
Date: 2011/12/17
Subject: [hello-world] Bugfix: build target when version.h changed. (#1)
To: Jiang Xin <[email protected]>
Without this fix, when version changed only version.h update, target rebuild needs a second `make`.
You can merge this Pull Request by running:
git pull https://github.com/gotgithub/hello-world patch-1
Or you can view, comment on it, or merge it online at:
https://github.com/ossxp-com/hello-world/pull/1
-- Commit Summary --
* Bugfix: build target when version.h changed.
-- File Changes --
M src/Makefile (3)
-- Patch Links --
https://github.com/ossxp-com/hello-world/pull/1.patch
https://github.com/ossxp-com/hello-world/pull/1.diff
---
Reply to this email directly or view it on GitHub:
https://github.com/ossxp-com/hello-world/pull/1
版本庫ossxp-com/hello-world的管理員既可以通過GitHub提供的圖形化界面完成對 Pull Request 的審核和合并，也可以在命令行下完成,。正如郵件中所述若使用命令行,，操作如下： $ git pull https://github.com/gotgithub/hello-world patch-1
|
|
|
