zh_tw/multiplayer.txt

   1 == 多人Git ==
   2
   3 我最初在一個私人項目上使用Git，那裡我是唯一的開發。在與Git分散式本性有關的命
   4 令中，我只用到了 *pull* 和 *clone*，用以在不同地方保持同一個項目。
   5
   6 後來我想用Git發佈我的代碼，並且包括其他貢獻者的變更。我不得不學習如何管理有來
   7 自世界各地的多個開發的項目，幸運的是，這是Git的長處，也可以說是其存在的理由。
   8
   9 === 我是誰？ ===
  10
  11 每個提交都有一個作者姓名和電子信箱，這顯示在 *git log* 裡。預設， Git使用系統
  12 設定來填充這些域。要顯示地設定，鍵入：
  13
  14   $ git config --global user.name "John Doe"
  15   $ git config --global user.email johndoe@example.com
  16
  17 去掉global選項設定只對當前倉庫生效。
  18
  19 === Git在SSH, HTTP上 ===
  20
  21 假設你有ssh訪問權限，以訪問一個網頁伺服器，但上面並沒有安裝Git。儘管比着它的
  22 原生協議效率低，Git也是可以通過HTTP來進行通信的。
  23
  24 那麼在你的帳戶下，下載，編譯並安裝Git。在你的網頁目錄裡創建一個Git倉庫：
  25
  26  $ GIT_DIR=proj.git git init
  27  $ cd proj.git
  28  $ git --bare update-server-info
  29  $ cp hooks/post-update.sample hooks/post-update
  30
  31 對較老版本的Git，只拷貝還不夠，你應運行：
  32
  33  $ chmod a+x hooks/post-update
  34
  35 現在你可以通過SSH從隨便哪個克隆發佈你的最新版本：
  36
  37  $ git push web.server:/path/to/proj.git master
  38
  39 那隨便誰都可以通過如下命令得到你的項目：
  40
  41  $ git clone http://web.server/proj.git
  42
  43 === Git在隨便什麼上 ===
  44
  45 想無需伺服器，甚至無需網絡連接的時候同步倉庫？需要在緊急時期湊合一下？我們
  46 已經看過<<makinghistory, *git fast-export* 和 *git fast-import* 可以轉換資源
  47 庫到一個單一檔案以及轉回來>>。 我們可以來來會會傳送這些檔案以傳輸git倉庫，
  48 通過任何媒介，但一個更有效率的工具是 *git bundle* 。
  49
  50 發送者創建一個“檔案包”：
  51
  52  $ git bundle create somefile HEAD
  53
  54 然後傳輸這個檔案包， +somefile+ ，給某個其他參與者：電子郵件，優盤，一個
  55 *xxd* 打印品和一個OCR掃描器，通過電話讀位元組，狼煙，等等。接收者通過鍵入如下命
  56 令從檔案包獲取提交：
  57
  58  $ git pull somefile
  59
  60 接收者甚至可以在一個空倉庫做這個。不考慮大小， +somefile+ 可以包含整個原先
  61 git倉庫。
  62
  63 在較大的項目裡，可以通過只打包其他倉庫缺少的變更消除浪費。例如，假設提交
  64 ``1b6d...''是兩個參與者共享的最近提交：
  65
  66  $ git bundle create somefile HEAD ^1b6d
  67
  68 如果做的頻繁，人可能容易忘記剛發了哪個提交。幫助頁面建議使用標籤解決這個問題。
  69 即，在你發了一個檔案包後，鍵入：
  70
  71  $ git tag -f lastbundle HEAD
  72
  73 並創建較新檔案包，使用：
  74
  75  $ git bundle create newbundle HEAD ^lastbundle
  76
  77 === 補丁：全球貨幣 ===
  78
  79 補丁是變更的文本形式，易於計算機理解，人也類似。補丁可以通吃。你可以給開發電
  80 郵一個補丁，不用管他們用的什麼版本控制系統。只要你的觀眾可以讀電子郵件，他們
  81 就能看到你的修改。類似，在你這邊，你只需要一個電子郵件帳號：不必搭建一個在綫
  82 的Git倉庫。
  83
  84 回想一下第一章：
  85
  86  $ git diff 1b6d > my.patch
  87
  88 輸出是一個補丁，可以粘貼到電子郵件裡用以討論。在一個Git倉庫，鍵入：
  89
  90  $ git apply < my.patch
  91
  92 來打這個補丁。
  93
  94 在更正式些的設置裡，當作者名字以及或許簽名應該記錄下的時候，為過去某一刻生成
  95 補丁，鍵入：
  96
  97  $ git format-patch 1b6d
  98
  99 結果檔案可以給 *git-send-email* 發送，或者手工發送。你也可以指定一個提交範圍：
 100
 101  $ git format-patch 1b6d..HEAD^^
 102
 103 在接收一端，保存郵件到一個檔案，然後鍵入：
 104
 105  $ git am < email.txt
 106
 107 這就打了補丁並創建了一個提交，包含諸如作者之類的信息。
 108
 109 使用瀏覽器郵件客戶端，在保存補丁為檔案之前，你可能需要建一個按鈕，看看郵件內
 110 容原來的原始形式。
 111
 112 對基于mbox的郵件客戶端有些微不同，但如果你在使用的話，你可能是那種能輕易找出
 113 答案的那種人，不用讀教程。
 114
 115 === 對不起，移走了 ===
 116
 117 克隆一個倉庫後，運行 *git push* 或 *git pull* 講自動推到或從原先URL拉。Git
 118 如何做這個呢？秘密在和克隆一起創建的配置選項。讓我們看一下：
 119
 120  $ git config --list
 121
 122 選項 +remote.origin.url+ 控制URL源；``origin'' 是給源倉庫的暱稱。和
 123 ``master'' 分支的慣例一樣，我們可以改變或刪除這個暱稱，但通常沒有理由這麼做。
 124
 125 如果原先倉庫移走，我們可以更新URL，通過：
 126
 127  $ git config remote.origin.url git://new.url/proj.git
 128
 129 選項 +branch.master.merge+ 指定 *git pull* 裡的預設遠端分支。在初始克隆的時候，
 130 它被設為原倉庫的當前分支，因此即使原倉庫之後挪到一個不同的分支，後來的
 131 pull也將忠實地跟着原來的分支。
 132
 133 這個選項只使用我們初次克隆的倉庫，它的值記錄在選項 +branch.master.remote+
 134 。如果我們從其他倉庫拉入，我們必須顯示指定我們想要哪個分支：
 135
 136  $ git pull git://example.com/other.git master
 137
 138 以上也解釋了為什麼我們較早一些push和pull的例子沒有參數。
 139
 140 === 遠端分支 ===
 141
 142 當你克隆一個倉庫，你也克隆了它的所有分支。你或許沒有注意到因為Git將它們隱藏
 143 起來了：你必須明確地要求。這使得遠端倉庫裡的分支不至于干擾你的分支，也使
 144 Git對初學者稍稍容易些。
 145
 146 列出遠端分支，使用：
 147
 148  $ git branch -r
 149
 150 你應該看到類似：
 151
 152  origin/HEAD
 153  origin/master
 154  origin/experimental
 155
 156 這顯示了遠端倉庫的分支和HEAD，可以用在常用的Git命令裡。例如，假設你已經做了
 157 很多提交，並希望和最後取到的版本比較一下。你可以搜索適當的SHA1哈希值，但使用
 158 下面命令更容易些：
 159
 160  $ git diff origin/HEAD
 161
 162 或你可以看看``experimental''分支都有啥：
 163
 164  $ git log origin/experimental
 165
 166 === 多遠端 ===
 167
 168 假設另兩個開發在同一個項目上工作，我們希望保持兩個標籤。我們可以同事跟多個倉庫：
 169
 170  $ git remote add other git://example.com/some_repo.git
 171  $ git pull other some_branch
 172
 173 現在我們已經從第二個倉庫合併到一個分支，並且我們已容易訪問所有倉庫的所有
 174 分支。
 175
 176  $ git diff origin/experimental^ other/some_branch~5
 177
 178 但如果為了不影響自己的工作，我們只想比較他們的變更怎麼辦呢？換句話說，我們想
 179 檢查一下他們的分支，又不使他們的變更入侵我們的工作目錄。那不是運行pull命令，
 180 而是運行：
 181
 182  $ git fetch        # Fetch from origin, the default.
 183  $ git fetch other  # Fetch from the second programmer.
 184
 185 這只是獲取歷史。儘管工作目錄維持不變，我們可以參考任何倉庫的任何分支，使用
 186 一個Git命令，因為我們現在有一個本地拷貝。
 187
 188 回想一下，在幕後，一個pull是簡單地一個 *fetch* 然後 *merge* 。通常，我們
 189 *pull* 因為我們想在獲取後合併最近提交；這個情況是一個值得注意的例外。
 190
 191 關於如何去除遠端倉庫，如何忽略特定分支等更多，參見 *git help remote* 。
 192
 193 === 我的喜好 ===
 194
 195 對我手頭的項目，我喜歡貢獻者去準備倉庫，這樣我可以從其中拉。一些Git伺服讓你
 196 點一個按鈕，擁有自己的分叉項目。
 197
 198 在我獲取一個樹之後，我運行Git命令去瀏覽並檢查這些變更，理想情況下這些變更組織
 199 良好，描述良好。我合併這些變更，也或許做些編輯。直到滿意，我才把變更推入主資
 200 源庫。
 201
 202 儘管我不經常收到貢獻，我相信這個方法擴展性良好。參見
 203 http://torvalds-family.blogspot.com/2009/06/happiness-is-warm-scm.html[ 這篇
 204 來自Linus Torvalds的博客 ]
 205
 206 獃在Git的世界裡比補丁檔案稍更方便，因為不用我將補丁轉換到Git提交。更進一步，
 207 Git處理諸如作者姓名和信箱地址的細節，還有時間和日期，以及要求作者描述他們的提
 208 交。