コンテンツにスキップ

「Mercurial」の版間の差分

提供: ArchWiki
削除された内容 追加された内容
update Pkg/AUR templates
Kgx (トーク | 投稿記録)
 
(同じ利用者による、間の4版が非表示)
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}}


証明書のフィンガープリントが検証されていないという Mercurial の警告削除するには、以下を {{ic|~/.hgrc}} に追加 ([http://mercurial.selenic.com/wiki/CACertificates Mercurial wiki] を参照):
グラフィカルブラウザ ''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}}{{Broken package link|{{aur-mirror|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 によるチュートリアル
* [http://bitbucket.org Bitbucket] - Mercurial リポジトリのフリー・商用ホスティング
* [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 ベースのツール。
https://www.mercurial-scm.org/wiki/HgkExtension || mercurial + tk
  • TortoiseHg — Mercurial 分散リビジョン管理システム用のグラフィカルツールと Nautilus 拡張機能のセット。
https://tortoisehg.bitbucket.io/ || tortoisehgAUR

設定

少なくともユーザー名は設定する必要があります。設定していないとコミットするときに 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 によって追跡させることができます。

ヒント .hgignore ファイルの一番上に syntax: glob を追加することで、リポジトリから簡単にファイルを除外できるようになります。

ヒントとテクニック

プログレスバー

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

~/.hgrc
[extensions]
progress =

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

~/.hgrc
[progress]
delay = 1.5

参照