如果曾经有人对 GitHub 只提供唯一的版本库格式(Git)托管表示过怀疑的话,那么今天看到 GitHub 对其他版本控制工具提供的愈发完善的支持,争议应该烟消云散了吧。
2008年4月1日,GitHub宣布推出基于SVN的SVNHub网站,后证实这是一个愚人节玩笑[1]。2010年愚人节,类似消息再起,可这一次不再是玩笑[2]。即对于GitHub上的每一个Git版本库,现在都可以用SVN命令进行操作。更酷的是 SVN 版本库使用的是和 Git 版本库同样的地址[3]。
例如用下面的 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 远程拷贝创建分支,需要通过本地拷贝再提交的方式创建新分支。操作如下:
$ svn checkout --depth=empty \
https://github.com/gotgit/gotgithub gotgithub-branches
Checked out revision 30.
$ cd gotgithub-branches
$ svn up --depth=empty trunk branches
A trunk
Updated to revision 30.
A branches
Updated to revision 30.
$ svn cp trunk branches/svn-github
A branches/svn-github
$ svn st
A + branches/svn-github
$ 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.
$ 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中提交。
$ cd ../gotgithub
$ svn switch https://github.com/gotgit/gotgithub/branches/svn-github
At revision 31.
$ svn st
M 06-side-projects/040-svn.rst
$ 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.
$ git ls-remote --heads https://github.com/gotgit/gotgithub
ce5d3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages
c4d370b1b0bafb103de14e104ca18b8c31d80add refs/heads/master
64b80cb5331e28fdfb896e2ab3085779bf6ca019 refs/heads/svn-github
Hg(又称Mercurial)和 Git 一样也是一个被广泛使用的分布式版本库控制工具。如果一个熟悉 Hg 的开发者参与托管在 GitHub 上的项目,大可不必为更换版本控制工具而苦恼,GitHub 上的一个名为 hg-git[1]的开源项目可以帮上忙。
得益于 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 版本库了。
$ 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
$ hg tags
tip 12:928384ca1e87
jx/v1.0-i18n 12:928384ca1e87
jx/v2.3 10:2767ad9d7008
...
使用hg pull命令和hg push命令可以实现和Git版本库的同步。
实际上 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