如果曾经有人对 GitHub 只提供唯一的版本库格式（Git）托管表示过怀疑的话，那么今天看到 GitHub 对其他版本控制工具提供的愈发完善的支持，争议应该烟消云散了吧。 # 6.2.1\. 用SVN操作GitHub 2008年4月1日，GitHub宣布推出基于SVN的SVNHub网站，后证实这是一个愚人节玩笑[[1]](https://github.com/blog/31-back-to-subversion)。2010年愚人节，类似消息再起，可这一次不再是玩笑[[2]](https://github.com/blog/626-announcing-svn-support)。即对于GitHub上的每一个Git版本库，现在都可以用SVN命令进行操作。更酷的是 SVN 版本库使用的是和 Git 版本库同样的地址[[3]](https://github.com/blog/966-improved-subversion-client-support)。 例如用下面的 Git 命令访问本书的 Git 版本库，显示版本库包含的引用。其中分支master用于维护书稿，分支gh-pages保存书稿编译后的 HTML 网页用于在 GitHub 上显示。 ~~~ $ git ls-remote --heads https://github.com/gotgit/gotgithub ce5d3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages c4d370b1b0bafb103de14e104ca18b8c31d80add refs/heads/master ~~~ 如果使用 SVN 命令访问相同的版本库地址，Git 服务器变身为一个 SVN 服务器，将Git的引用对应为 SVN 风格的分支。如下： ~~~ $ svn ls https://github.com/gotgit/gotgithub branches/ trunk/ $ svn ls https://github.com/gotgit/gotgithub/branches gh-pages/ ~~~ SVN 支持部分检出，下面命令将整个主线trunk（相当于 Git 版本库的master分支）检出。 ~~~ $ svn checkout https://github.com/gotgit/gotgithub/trunk gotgithub A gotgithub/Makefile A gotgithub/README.rst ... Checked out revision 30. ~~~ 还可以使用 SVN 命令创建分支，即相当于在 Git 版本库中创建新的引用。测试发现GitHub 尚不支持 SVN 远程拷贝创建分支，需要通过本地拷贝再提交的方式创建新分支。操作如下： 1. 为避免检出版本库所有分支过于耗时，在检出时使用--depth=empty参数。 ~~~ $ svn checkout --depth=empty \ https://github.com/gotgit/gotgithub gotgithub-branches Checked out revision 30. ~~~ 2. 进入到检出目录中，更新出trunk和branches两个顶级目录。 ~~~ $ cd gotgithub-branches $ svn up --depth=empty trunk branches A trunk Updated to revision 30. A branches Updated to revision 30. ~~~ 3. 通过拷贝从主线trunk创建分支branches/svn-github。 ~~~ $ svn cp trunk branches/svn-github A branches/svn-github $ svn st A + branches/svn-github ~~~ 4. 提交完成分支创建。 ~~~ $ svn ci -m "create branch svn-github from trunk" Authentication realm: <https://github.com:443> GitHub Username: gotgithub Password for 'gotgithub': Adding branches/svn-github Committed revision 31. ~~~ 5. 用 Git 命令可以看到服务器上创建了一个新的同名引用，并且指向和master一致。 ~~~ $ git ls-remote --heads https://github.com/gotgit/gotgithub ce5d3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages c4d370b1b0bafb103de14e104ca18b8c31d80add refs/heads/master c4d370b1b0bafb103de14e104ca18b8c31d80add refs/heads/svn-github ~~~ 下面尝试一下用 SVN 命令在新创建的分支svn-github中提交。 1. 进入到之前检出完整主线trunk的gotgithub目录，并将工作区切换为分支branches/svn-github。 ~~~ $ cd ../gotgithub $ svn switch https://github.com/gotgit/gotgithub/branches/svn-github At revision 31. ~~~ 2. 修改文件，查看工作区状态。 ~~~ $ svn st M 06-side-projects/040-svn.rst ~~~ 3. 用 SVN 提交。 ~~~ $ svn ci -m "GitHub svn client support improved. Refs: http://git.io/svn" Sending 06-side-projects/040-svn.rst Transmitting file data . Committed revision 32. ~~~ 4. 同样查看 Git 版本库的更新，会发现svn-github分支的指向已和master不同。 ~~~ $ git ls-remote --heads https://github.com/gotgit/gotgithub ce5d3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages c4d370b1b0bafb103de14e104ca18b8c31d80add refs/heads/master 64b80cb5331e28fdfb896e2ab3085779bf6ca019 refs/heads/svn-github ~~~ # 6.2.2\. 用Hg操作GitHub Hg（又称Mercurial）和 Git 一样也是一个被广泛使用的分布式版本库控制工具。如果一个熟悉 Hg 的开发者参与托管在 GitHub 上的项目，大可不必为更换版本控制工具而苦恼，GitHub 上的一个名为 hg-git[[1]](https://github.com/schacon/hg-git)的开源项目可以帮上忙。 得益于 Hg 的强大的插件扩展机制，安装 hg-git 并将其注册为Hg 插件后可提供Hg操作 Git 版本库的能力。安装 hg-git 可以直接使用 **easy_install** 命令： ~~~ $ sudo easy_install hg-git ~~~ 还可以直接从GitHub上下载hg-git最新代码进行安装： ~~~ $ curl -L -k -o hg-git.zip https://github.com/schacon/hg-git/zipball/master $ unzip hg-git.zip $ cd schacon-hg-git-* $ sudo easy_install . ~~~ 插件 hg-git 依赖于 Dulwich 项目，如果在安装过程遇到 Dulwich 无法编译，可能是因为缺乏 C 编译器，或者尚未安装 python-dev 软件包。Dulwich 是一个Python语言的 Git 实现，因此 hg-git 在运行过程中无需 Git 命令行。 和其他 Hg 插件类似，安装完毕后需要修改Hg配置文件（如文件 ~/.hgrc ）如下，以启用 hg-git 插件以及另外一个必须的 Hg 内置插件 —— bookmarks 插件。 ~~~ [extensions] bookmarks = hggit = ~~~ 对 hg-git 安装配置完毕，就可以使用 Hg 操作 Git 版本库了。 * 克隆 Git 版本库。 ~~~ $ hg clone git://github.com/ossxp-com/hello-world.git $ cd hello-world ~~~ * Git 版本库的分支转换为 Hg 版本库中的 bookmarks。 新克隆的 Hg 版本库默认会更新到最新提交（即 tip 版本），未必处于所需的分支上。用命令**hg bookmarks**显示分支列表，命令**hg parents**显示工作区对应的版本。 ~~~ $ hg bookmarks helper/master 10:2767ad9d7008 helper/v1.x 8:994c2f0adc0b master 1:dcd365e3175c $ hg parents 修改集: 12:928384ca1e87 标签: jx/v1.0-i18n 标签: tip 用户: Jiang Xin <jiangxin@ossxp.com> 日期: Fri Dec 31 12:12:42 2010 +0800 摘要: Translate for Chinese. ~~~ * 切换到所需的工作分支（如master分支）。 用hg update -r命令切换分支。之后执行**hg bookmarks**命令会看到当前工作分支用星号标识出来。 ~~~ $ hg update -r master $ hg book helper/master 10:2767ad9d7008 helper/v1.x 8:994c2f0adc0b * master 1:dcd365e3175c ~~~ * Git 的里程碑也被记录，并可被 **hg tags** 命令显示。 ~~~ $ hg tags tip 12:928384ca1e87 jx/v1.0-i18n 12:928384ca1e87 jx/v2.3 10:2767ad9d7008 ... ~~~ * 使用**hg pull**命令和**hg push**命令可以实现和Git版本库的同步。 * 有的命令如**hg outgoing**可在 1.7 版本的Hg中运行正常，但对于高版本库的 Hg 存在兼容性问题。 实际上 hg-git 插件并非只针对 GitHub 的版本库，而是可以支持任意 Git 版本库包括本地 Git 版本库。为了提供对 Git 版本库的透明支持，对 Git 版本库的 URL的写法有特殊要求，即要能够从协议名称区分开 Git 版本库和默认的 Hg 版本库。 * Git协议： git://example.com[:port]/path/to/repo.git * SSH协议： git+ssh://[user@]example.com[:port]/path/to/repo.git * HTTP协议： git+http://[user@]example.com[:port]/path/to/repo.git * HTTPS协议： git+https://[user@]example.com[:port]/path/to/repo.git * 本地协议： /path/to/repo.git