zh_cn/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 交。