Mercurialのソースを表示

[[Category:バージョン管理システム]]
[[en:Mercurial]]
[http://mercurial.selenic.com/ Mercurial] (しばしば '''hg''' と呼称されます) は Python で書かれた分散型バージョン管理システムであり [[Git]], [http://bazaar.canonical.com/ Bazaar], [[Darcs]] と多くの点で似ているところがあります。

== インストール ==

{{Pkg|mercurial}} を[[インストール]]します、開発版の場合は、{{AUR|mercurial-hg}} をインストールしてください。

=== グラフィカルフロントエンド ===

[https://www.mercurial-scm.org/wiki/OtherTools#Graphical_user_interfaces Mercurial グラフィカルユーザーインターフェイス] も参照してください。

* {{App|hgk|リポジトリの履歴をグラフィカルに参照するための Tcl/Tk ベースのツール。|https://www.mercurial-scm.org/wiki/HgkExtension|{{Pkg|mercurial}} + {{Pkg|tk}}}}
* {{App|[[Wikipedia:TortoiseHg|TortoiseHg]]|Mercurial 分散リビジョン管理システム用のグラフィカルツールと Nautilus 拡張機能のセット。|https://tortoisehg.bitbucket.io/|{{AUR|tortoisehg}}}}

== 設定 ==

少なくともユーザー名は設定する必要があります。設定していないとコミットするときに mercurial はエラーを吐きます。{{ic|~/.hgrc}} を編集して以下を追加することでユーザー名を設定できます:

{{hc|~/.hgrc|2=[ui]
username = John Smith <johnsmith@domain.tld>}}

グラフィカルブラウザ ''hgk'' 別名 {{ic|hg view}} を使うには、以下を {{ic|~/.hgrc}} に追加してください ([https://bbs.archlinux.org/viewtopic.php?id=31999 フォーラムスレッド] を参照):

{{hc|~/.hgrc|2=[extensions]
hgk=}}

以下の難解なエラーメッセージを出ないようにするには {{ic|hg view}} を実行する前に {{Pkg|tk}} をインストールする必要があります:

 /usr/bin/env: wish: No such file or directory

== 使用方法 ==

mercurial のコマンドは全て ''hg'' から始まります。一般的なコマンドのリストを見るには、次を実行:
{{bc|$ hg help}}

各コマンドにはヘルプ ページがあり、次のコマンドを使用して読むことができます。
 $ hg help ''subcommand''

既存のリポジトリ (コードまたはファイルのコレクション) を操作することも、独自のリポジトリを作成して共有することもできます。

既存のリポジトリを操作するには、選択したディレクトリにリポジトリのクローンを作成する必要があります:

 $ mkdir mercurial
 $ cd mercurial
 $ hg clone https://repo.mercurial-scm.org/hello

自分でリポジトリを作成するにいは、共有したいディレクトリに移動して mercurial プロジェクトを開始します:

 $ cd myfiles
 $ hg init myfiles

=== ドットファイルリポジトリ ===

{{ic|~/.}} ファイルのリポジトリを作成したいときは、ホームフォルダでプロジェクトを開始します:
{{bc|$ hg init}}

追跡したい特定のファイルを追加するときは:
{{bc|$ hg add |file1 file2 file3}}

{{ic|~/.hgignore}} を作成することでリポジトリに含めたいファイルだけを mercurial によって追跡させることができます。
{{Tip|{{ic|.hgignore}} ファイルの一番上に {{ic|syntax: glob}} を追加することで、リポジトリから簡単にファイルを除外できるようになります。}}

== ヒントとテクニック ==

=== プログレスバー ===

大規模なリポジトリを操作する場合は、''progress'' 拡張子を {{ic|~/.hgrc}} ファイルに追加して有効にすることをお勧めします。

{{hc|~/.hgrc|2=[extensions]
progress =}}

これにより、3 秒を超える操作については進行状況バーが表示されます。進行状況バーをより早く表示したい場合は、設定ファイルに以下を追加できます。

{{hc|~/.hgrc|2=[progress]
delay = 1.5}}

== 参照 ==

* [http://hgbook.red-bean.com/read/ Mercurial: The Definitive Guide] ([https://bitbucket.org/foozy/hgbook-ja/wiki/Home 日本語版])
* [http://hginit.com/ hginit.com] - Joel Spolsky によるチュートリアル
* [http://mercurial.aragost.com/kick-start/en/ Mercurial Kick-Start] - Aragost によるチュートリアル
* [https://wiki.mercurial-scm.org/MercurialHosting Mercurial Hosting] - Mercurial ホスティングを提供するサービスのリスト Mercurial 公式 wiki より