Mercurial与TortoiseHg使用入门教程

Mercurial与TortoiseHg使用入门教程

文章来源：http://www.keakon.cn/bbs/thread-1865-1-1.html

分布式版本管理工具当中，Git和Mercurial（意思为水银的，于是经常缩写为Hg）是最为流行的工具。大名鼎鼎的Linux就用Git作源码管理，而Python和Firefox则采用Hg（你可以在这找到一堆使用Hg的项目 ）。

1.为何要用 分布式配置管理

2.为何选择Mercurial

   

因为Git的优势主要在于分支，而汉化并不需要太多分支；而Git对Windows的支持似乎不如 Mercurial，ssh也比http麻烦，比较难教汉化组成员们使用；此外还有个特别的原因：Hg主要是用Python实现的（小部分使用C实现）。
Hg也有个很严重的缺点：不支持针对单个文件夹的分支。如果剧本翻译和改图要建立分支都必须复制整个仓库，而对翻译来说，图像文件并不是他需要的部分。

附：Google还发了篇《Analysis of Git and Mercurial》 ，说明为什么Google Code决定支持Hg，而不支持Git。
Git的优势：

 客户端存储控制。可以删除任意的版本，而无需考虑该分支的后续版本，而Hg做不到。

 无限的父结点数。Hg一次只能分成2个分支，合并N个分支要进行很多次操作。而Git没有限制。

 支持rebase。它可以将当前版本移到最新的分支去。例如假设有个本地库在开发1.0的新特性，而基线已经升级到1.1了；一般情况下是需要合并到1.1去的，而rebase可以避免这种操作。

Hg的优势：

 

 学习曲线。由于很多因素，Git比Hg的学习曲线更陡峭。

 支持Windows。

 维护。Git需要定期维护。

 历史是不可侵犯的。Git很强大，可以干几乎任何事，因此也会丢失历史信息。

看起来Git在技术上是要强于Hg的，不过由于文件操作的实现依赖于操作系统，移植到Bigtable会存在麻烦；而且Hg有很好的基于HTTP的无状态pushing和pulling，容易与Google的构架整合（Google几乎所有的服务都基于HTTP）。
对于这点，Google还特意提供了测试数据，指出在使用HTTP时，Git比Hg慢1个数量级。（提到了2个数字，分别慢22倍和12倍。）

3.哪里可以免费托管代码：

 

 GitHub ：这个网站非常出名，是用RoR建的，300MB的免费空间，支持Git，但不支持Hg（虽然有插件，但教别人用太麻烦），而且没有私有库。

 bitbucket ：这个是用Django建的，可以建1个私有库，150MB的免费空间，支持Hg。

 ProjectLocker ：只有（无限个）私有库，500MB的免费空间，支持SVN和Git，但只能有5个用户。闭源项目推荐，但显然不适合庞大的tomo汉化组。

 Unfuddle ：200MB的免费空间，支持SVN和Git，只能有1个库和2个用户。

最终我选择了最小的bitbucket，因为也差不多够用了。
（注：Google Code现已支持Hg，但只能托管源码，不能用于其他目的，所以我只能放弃。但如果你是开源软件开发，那么Google Code是最大方的，还可以发信申请扩大配额，只是偶尔会被GFW。）

4. TortoiseHg 的安装

接着就开始装软件了。习惯了SVN的乌龟，所以仍然选择了乌龟汞（TortoiseHg ）。
目前这个版本支持Windows XP、Vista和Windows 7，所以不担心兼容性。
安装很简单，装好后要重启（其实不重启也可以用）。
喜欢命令行的还可以在CMD里输入hg试试。

5.让 TortoiseHg 界面显示中文

需要建一个“LANGUAGE”环境变量（在系统属性里），值为“zh_CN”。
  
接着还得去这个文件夹：C:\Program Files\TortoiseHg\cmenu_i18n，导入thg-cmenu-zh_CN.reg文件。
修改之后，软件界面和命令行（hg和hgtk）就已经是中文了，但右键菜单还是英文，重启或注销即可变成中文。

6.Mercurial基本操作

  在使用前，建议看看《Mercurial 使用教程》 ，了解下几个术语。
Init 是指初始化，也就是创建一个空的仓库。
Clone 是指创建仓库的复本，创建的来源可以是一个http或ssh链接表示的仓库，也可以是本地仓库。
Commit 是 指提交，即接受所有的改动，将当前版本作为最新版本（也叫tip）。注意这个提交和集中式SCM不同，它只提交的本地仓库，而且本地仓库会 详细记录所有的变动（称为变更集或改动集）。因此不用客气，多提交几次也没关系，因为不影响别人的仓库。而如果怕影响自己的话，可以clone一个复本， 再对复本进行改写和提交。
Revert 是指恢复，即撤销所有的改动，恢复到未更改的状态。右键菜单里你是找不到它的，原因后面再提。
Pull的意思是拉，是将其他仓库有，而当前仓库没有的变更集“下载”到当前仓库。不过这只是添加了变更集，文件并不会改动。（变更集有一个唯一的hash标识，所以很容易区分。）
Update 的意思就是更新，当获取了其他变更集，且需要更改以保持和其他仓库一致时，就可以执行它了。
Push 的意思是推，就是将当前仓库的变更集“上传”到其他仓库去。其他仓库必须支持该操作，并可能需要经过验证。如果是从本地仓库A push到本地仓库B，就相当于用B pull A。此外，push也不会更新仓库的版本，因为它是共享的，需要的人直接选择想要的版本即可。
Merge 就是指合并。当一个文件同时被多次修改，并存放在多个仓库时，要获得一个统一的版本，就需要合并。对于翻译而言，一个文本可能同时会分给多个人，于是合并时只需要接受每个人的改动即可。

如果你还想了解更多，可以读读《Mercurial: The Definitive Guide》 。

这些术语介绍完后，就可以看看别人写的使用方法了：
Git Vs Mercurial hg? 异地协同开发，分布式SCM方案选择！ 
CodeBeamer+Mercurial实务操作手册 
当然，那个PDF文档也是很有用的资料。

不过为了汉化组的同志们，我还是截图说明如何进行完整的操作吧。

首先去我的bitbucket主页 ，找到FamilyProject 这个项目。
下面会有一些提示：

引用:

Clone this repository (size: 4.3 MB): HTTPS / SSH
$ hg clone https://[email protected]/keakon/familyproject/

接着在你的硬盘任何位置新建一个文件夹，起名为FamilyProject。
进入这个文件夹，右键点击空白处，在TortoiseHg菜单里选“克隆”。
 
在源路径处填入刚才看到的地址：https://[email protected]/keakon/familyproject/ ，再点“克隆”按钮，等待下载完成即可。
 
下载完成后，你便拥有完整的项目文件了，可以对其进行更改等操作。

接下来进行一个克隆操作，将它复制到另一个本地仓库。方法很简单，和之前的克隆一样，不过源路径填刚才生成的文件夹，目标路径填新文件夹：
 
这次操作应该1、2秒就完成了，因为是本地复制。

接着用文本编辑器打开FamilyProject里的一个文件，例如SNR02.ISF。
会发现第1句是：●0001●　ロードに失敗しました。
把它改成：读取失败。
然后右键点FamilyProject文件夹，选择“HG 提交”。
 
这时会列出改动的文件和具体的差异。填写一下描述，再点提交按钮。
 

再打开FamilyProject-new里的同名文件，找到第2句：●0002●　終了します。
把它改成：读取失败。
然后也进行同样的提交操作。

现在你在2个仓库里就有2个不同的分支，于是看看如何合并它。
先右键点FamilyProject文件夹，选择“HG 仓库浏览器”。
 
然后在地址栏里填上新仓库的地址，点“拉取改动集”按钮：
 
这时你会发现，最新的tip版变成了FamilyProject-new里的版本了，而且多了一个分支。
但是打开文件来看，仍然没变。此时我们可以右键点最上面的改动集，选择“更新”操作（上一步也可以选择“拉取后更新”来自动完成），来切换版本。
 
注意版本已经列出来了，有改动集编号、改动集hash标识、描述、是否为default和tip版本等几种提示，所以应该不会弄错。
 
确认无误后就可以点“更新”按钮了，这时你会发现你的文件变成FamilyProject-new里的版本了，但自己的改动却丢失了（别紧张，文件没丢失）。
原因很简单，更新只是切换改动集版本而已，并不会进行合并。如果要换回自己的版本，右键点下面那个改动集，选“更新”就行了。

但是我的目的是合并，而非更新，所以下面继续说明合并。
操作很简单，右键点第2个分支，选择“合并”操作。
 
点击“合并”按钮。
 
由于改动的地方都不一样，所以并不冲突，于是顺利合并成功了。接着点“提交”按钮。
 
这时就列出改动的地方了，-号表示删除，+表示新增。可以看到2处改动都正确判断了，因此不需要我们做其他的事，直接点“提交”按钮即可。
 
再看看改动集，分支已经合并了，而你的文件也成功更新了。
 

不过FamilyProject-new里的文件还是旧版本。
如果你不需要了，直接删除这个文件夹就行了；如果还想继续使用的话，也打开它的“HG 仓库浏览器”，选择“拉取后更新”，再点“拉取改动集”按钮：
 
操作完后，2个仓库就完全一样了，你就可以继续其他操作了。

如果你改完了，需要传给别人，则需要push给别人，或叫别人来pull，这个操作实际上和本地仓库的操作是差不多的。
最简单的方法就是发布到本地的Web服务器。
右键点文件夹，选择“TortoiseHg - Web服务器”：
 
出现了一个窗口（顺带一提，这个玩意很容易就能看出是Python写的），不过先别着急，还得点“配置”按钮设置一下：
 
把“SSL加密推送”设为“False”，因为你没有SSL证书。在“允许推送”处填允许的用户名，为了省事，填个“*”就允许所有人推送了。下面的编码也得改成和文件编码一致，免得在线查看文件时乱码。
 
确定后返回，在端口处填一个小于65535的数，默认为8000，然后点“启动”按钮。
 
启动好后，就可以通过浏览器来访问了，地址为：http://你的IP:端口号/。
 

接下来就试试推送吧。
打开FamilyProject-new的文件夹，更改一下文件，然后提交。
这次我就不用仓库浏览器了，因为它太庞大了，而改用小巧的“同步”操作：
 
填入刚才你用浏览器访问的地址，然后点“推送”按钮，推送就完成了。
 
接着你就可以去FamilyProject文件夹查看改动集了，需要的话可以按前面所说的进行更新和合并操作。

不过这个IP地址有可能是外部不能访问的，也许是网关或防火墙的设置导致的，这样你的Web服务器就不能被其他人访问了。
一个临时的解决办法就是邮寄。不过在这之前，你还得改下邮件设置。
于是右键点文件夹，选择“TortoiseHg - 全局设置”：
 
在“邮件”里填上你的邮箱信息：
 
这里有Gmail的配置说明 ，其他的照着填就行了。
注意密码是邮箱的登录密码。如果你填了，会以明文的形式保存起来，所以如果你的电脑还有别人用，就不要填，不过发送邮件时就需要手动输入密码了。

配置完后回到同步窗口，点“邮寄”按钮，然后填写邮件内容。注意把“附件”勾上，然后点击发送。
 
不过网络不好时很可能失败，成功后对方会收到一封邮件，包含一个.patch类型的附件。
但是TortoiseHg并不支持导入这个patch文件，只能通过命令行来执行。
于是接受者可以运行CMD，切换到需要导入的仓库，然后执行这行命令：

引用:

hg import patch文件名

当然，命令行对某些人来说是很恐怖的，于是再换个方法：去bitbucket建立自己的仓库。
注册我就不说了，可以新注册一个账号，也可以使用OpenID。
登录以后然后到FamilyProject项目去，点击那个fork 链接。
 
Fork的意思是以我的仓库为蓝本，创建一个复本。和clone差不多，只不过是在远程进行的。
在新页面填写项目的名字，然后点击“Advanced settings”，进行更多的设定，最后点“Create fork”按钮来创建。
 
和你在本地clone一样，远程的fork也是几秒钟就完成了，并自动重定向到了这个仓库。（结果发现这个仓库居然小了一半，看来空间占用是很诡异的。）
 

接下来你就可以对这个仓库进行操作了，方法和自建的Web服务器一样。
当改动完时，需要通知别人时，再次来到FamilyProject项目，点击那个“pull request”按钮。
在新的页面里填写邮件内容，附上你的仓库地址；再把需要通知的人勾选上；最后点“Send request”按钮发送即可。
收到邮件的人就可以去你的仓库进行pull操作来获取更新了。

之后的合并等操作前面也说过了，也就不重提了。
如果空间不够用了，再创建一个账号是最方便的方法。
当然也可以去“Admin”标签，点右下角的“Delete repository”按钮，这样就能删除不要的仓库的。
此外，这里还有个“Repository management”链接，进去后可以执行strip操作，删除不需要的版本。
不过删除后好像没增加空间，郁闷了…于是发信给客服，整了半天还没搞定，我们通信的频率大概是2小时一次…