「Mercurial」の版間の差分
(同期) |
(→使用方法: 同期) |
||
(2人の利用者による、間の5版が非表示) | |||
4行目: | 4行目: | ||
== インストール == |
== インストール == |
||
+ | |||
− | [[公式リポジトリ]]の {{Pkg|mercurial}} を[[インストール]]してください。 |
||
+ | {{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}} を編集して以下を追加することでユーザー名を設定できます: |
少なくともユーザー名は設定する必要があります。設定していないとコミットするときに mercurial はエラーを吐きます。{{ic|~/.hgrc}} を編集して以下を追加することでユーザー名を設定できます: |
||
− | {{hc|~/.hgrc|2=[ui]<br/>username = John Smith}} |
||
+ | {{hc|~/.hgrc|2=[ui] |
||
− | グラフィカルブラウザ '''hgk''' (別名 '''hg view''') を使うには、以下を {{ic|~/.hgrc}} に追加してください ([https://bbs.archlinux.org/viewtopic.php?id=31999 フォーラムスレッド] を参照): |
||
+ | username = John Smith <johnsmith@domain.tld>}} |
||
− | {{hc|~/.hgrc|2=[extensions]<br/>hgk=}} |
||
− | 以下の難解なエラーメッセージを出ないようにするには '''hg view''' を実行する前に {{Pkg|tk}} をインストールする必要があります: |
||
− | {{bc|/usr/bin/env: wish: No such file or directory}} |
||
− | + | グラフィカルブラウザ ''hgk'' 別名 {{ic|hg view}} を使うには、以下を {{ic|~/.hgrc}} に追加してください ([https://bbs.archlinux.org/viewtopic.php?id=31999 フォーラムスレッド] を参照): |
|
− | {{hc|~/.hgrc|2=[web]<br/>cacerts = /etc/ssl/certs/ca-certificates.crt}} |
||
+ | {{hc|~/.hgrc|2=[extensions] |
||
− | 巨大なリポジトリを扱う場合 (例: {{AUR|ttf-google-fonts-hg}})、''progress'' 拡張を {{ic|~/.hgrc}} ファイルに追加して有効にすると良いでしょう: |
||
+ | hgk=}} |
||
− | {{hc|~/.hgrc|2=[extensions]<br/>progress =}} |
||
+ | |||
− | 上記の設定で、3秒以上かかる操作をしたときにプログレスバーが表示されます。すぐにプログレスバーを表示させたい場合は、設定ファイルに以下を追記してください: |
||
+ | 以下の難解なエラーメッセージを出ないようにするには {{ic|hg view}} を実行する前に {{Pkg|tk}} をインストールする必要があります: |
||
− | {{hc|~/.hgrc|2=[progress]<br/>delay = 1.5}} |
||
+ | |||
+ | /usr/bin/env: wish: No such file or directory |
||
== 使用方法 == |
== 使用方法 == |
||
+ | |||
mercurial のコマンドは全て ''hg'' から始まります。一般的なコマンドのリストを見るには、次を実行: |
mercurial のコマンドは全て ''hg'' から始まります。一般的なコマンドのリストを見るには、次を実行: |
||
{{bc|$ hg help}} |
{{bc|$ hg help}} |
||
− | + | 各コマンドにはヘルプ ページがあり、次のコマンドを使用して読むことができます。 |
|
+ | $ hg help ''subcommand'' |
||
− | 既存のリポジトリ |
+ | 既存のリポジトリ (コードまたはファイルのコレクション) を操作することも、独自のリポジトリを作成して共有することもできます。 |
+ | |||
− | {{bc|$ mkdir mercurial<br/>$ cd mercurial<br/>$ hg clone http://hg.serpentine.com/tutorial/}} |
||
+ | 既存のリポジトリを操作するには、選択したディレクトリにリポジトリのクローンを作成する必要があります: |
||
+ | |||
+ | $ mkdir mercurial |
||
+ | $ cd mercurial |
||
+ | $ hg clone https://repo.mercurial-scm.org/hello |
||
自分でリポジトリを作成するにいは、共有したいディレクトリに移動して mercurial プロジェクトを開始します: |
自分でリポジトリを作成するにいは、共有したいディレクトリに移動して mercurial プロジェクトを開始します: |
||
+ | |||
− | {{bc|$ cd myfiles<br/>$ hg init myfiles}} |
||
+ | $ cd myfiles |
||
+ | $ hg init myfiles |
||
=== ドットファイルリポジトリ === |
=== ドットファイルリポジトリ === |
||
+ | |||
{{ic|~/.}} ファイルのリポジトリを作成したいときは、ホームフォルダでプロジェクトを開始します: |
{{ic|~/.}} ファイルのリポジトリを作成したいときは、ホームフォルダでプロジェクトを開始します: |
||
{{bc|$ hg init}} |
{{bc|$ hg init}} |
||
45行目: | 62行目: | ||
{{Tip|{{ic|.hgignore}} ファイルの一番上に {{ic|syntax: glob}} を追加することで、リポジトリから簡単にファイルを除外できるようになります。}} |
{{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://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://hginit.com/ hginit.com] - Joel Spolsky によるチュートリアル |
||
* [http://mercurial.aragost.com/kick-start/en/ Mercurial Kick-Start] - Aragost によるチュートリアル |
* [http://mercurial.aragost.com/kick-start/en/ Mercurial Kick-Start] - Aragost によるチュートリアル |
||
− | * [ |
+ | * [https://wiki.mercurial-scm.org/MercurialHosting Mercurial Hosting] - Mercurial ホスティングを提供するサービスのリスト Mercurial 公式 wiki より |
− | * [http://mercurial.intuxication.org/ Intuxication] - フリーの Mercurial ホスティング |
2024年3月5日 (火) 03:48時点における最新版
Mercurial (しばしば hg と呼称されます) は Python で書かれた分散型バージョン管理システムであり Git, Bazaar, Darcs と多くの点で似ているところがあります。
インストール
mercurial をインストールします、開発版の場合は、mercurial-hgAUR をインストールしてください。
グラフィカルフロントエンド
Mercurial グラフィカルユーザーインターフェイス も参照してください。
- hgk — リポジトリの履歴をグラフィカルに参照するための Tcl/Tk ベースのツール。
- TortoiseHg — Mercurial 分散リビジョン管理システム用のグラフィカルツールと Nautilus 拡張機能のセット。
設定
少なくともユーザー名は設定する必要があります。設定していないとコミットするときに mercurial はエラーを吐きます。~/.hgrc
を編集して以下を追加することでユーザー名を設定できます:
~/.hgrc
[ui] username = John Smith <johnsmith@domain.tld>
グラフィカルブラウザ hgk 別名 hg view
を使うには、以下を ~/.hgrc
に追加してください (フォーラムスレッド を参照):
~/.hgrc
[extensions] hgk=
以下の難解なエラーメッセージを出ないようにするには hg view
を実行する前に tk をインストールする必要があります:
/usr/bin/env: wish: No such file or directory
使用方法
mercurial のコマンドは全て hg から始まります。一般的なコマンドのリストを見るには、次を実行:
$ hg help
各コマンドにはヘルプ ページがあり、次のコマンドを使用して読むことができます。
$ hg help subcommand
既存のリポジトリ (コードまたはファイルのコレクション) を操作することも、独自のリポジトリを作成して共有することもできます。
既存のリポジトリを操作するには、選択したディレクトリにリポジトリのクローンを作成する必要があります:
$ mkdir mercurial $ cd mercurial $ hg clone https://repo.mercurial-scm.org/hello
自分でリポジトリを作成するにいは、共有したいディレクトリに移動して mercurial プロジェクトを開始します:
$ cd myfiles $ hg init myfiles
ドットファイルリポジトリ
~/.
ファイルのリポジトリを作成したいときは、ホームフォルダでプロジェクトを開始します:
$ hg init
追跡したい特定のファイルを追加するときは:
$ hg add
~/.hgignore
を作成することでリポジトリに含めたいファイルだけを mercurial によって追跡させることができます。
ヒントとテクニック
プログレスバー
大規模なリポジトリを操作する場合は、progress 拡張子を ~/.hgrc
ファイルに追加して有効にすることをお勧めします。
~/.hgrc
[extensions] progress =
これにより、3 秒を超える操作については進行状況バーが表示されます。進行状況バーをより早く表示したい場合は、設定ファイルに以下を追加できます。
~/.hgrc
[progress] delay = 1.5
参照
- Mercurial: The Definitive Guide (日本語版)
- hginit.com - Joel Spolsky によるチュートリアル
- Mercurial Kick-Start - Aragost によるチュートリアル
- Mercurial Hosting - Mercurial ホスティングを提供するサービスのリスト Mercurial 公式 wiki より