このドキュメントはQuickStartの翻訳です。
クィックスタート
(JapaneseUnderstandingMercurialと["JapaneseTutorial"]とJapaneseQuickStart2もご覧下さい)
1. ユーザー名を設定する
デフォルトではMercurialはコミットに対して'user@localhost'の形式のユーザー名を使います。 これが無意味であることがよくあります。次のように~/.hgrc(Windowsの場合は%USERPROFILE%\Mercurial.ini)に適切なEメールアドレスを設定することがベストです:
[ui] username = Author Name <email@address>
2. 既存のMercurialプロジェクトを取り組む
[:Repository:repository] (例えば http://selenic.com/hg )のようなブラウザで閲覧できるURLがあれば、次のようにコピーを入手できます:
$ hg clone http://selenic.com/hg mercurial-repo
このコマンドによってmercurial-repoという新しいディレクトリが作成され、完全なプロジェクトの履歴が入手でき、topmost [:ChangeSet:changeset] (["Clone"]も参照)をチェックアウトします。
3. 新しいMercurialプロジェクトをセットアップする
次のコマンドでリポジトリを作ります:
$ cd project/ $ hg init # .hgを作成する
Mercurialはリポジトリのrootで[".hgignore"]という名前のファイルを探します。これはファイルパスで無視するためのglobパターンと正規表現のセットを含みます。.hgignoreファイルの例です:
syntax: glob *.orig *.rej *~ *.o tests/*.err syntax: regexp .*\#.*\#$
次のコマンドで.hgignoreファイルを試して下さい:
$ hg status # すべての無視されないファイルを示す
このコマンドによって'?'フラグ(追跡されません)で無視されないすべてのファイルの一覧が表示されます。追跡したいファイルのみがステータスによって一覧表示されるまで.hgignoreファイルを編集して下さい。.hgignoreファイルも追跡したいことでしょう！しかしおそらくビルドプロセスによって生成されたファイルを追跡したくないでしょう。満足したら、追加するファイルを予約し、[:Commit:コミット]します:
$ hg add # 'unknown'ファイルを追加する $ hg commit # すべての変更をコミットし、チェンジログエントリを編集する
4. クローン、コミット、マージ
$ hg clone project project-work # リポジトリをクローンする $ cd project-work $ <make changes> $ hg commit $ cd ../project $ hg pull ../project-work # project-workからチェンジセットをpullする $ hg merge # project-workからの新しいtipをワーキングディレクトリにマージする $ hg commit # マージの結果をコミットする
関連項目: [:Clone], [:Commit], [:Pull], [:Merge]
5. パッチをエクスポートする
(make changes) $ hg commit $ hg export tip # 最新のコミットをエクスポートする
関連記事: [:Export]
6. ネットワークサポート
# Mercurialの主要なリポジトリからクローンする foo$ hg clone http://selenic.com/hg/ foo$ cd hg # 既存のレポを更新する foo$ hg pull http://selenic.com/hg/ # ブラウザで閲覧できるインターフェイスでHTTP経由で現在のリポジトリをエクスポートする foo$ hg serve -n "My repo" -p 80 # SSHで変更をリモートリポジトリにプッシュする foo$ hg push ssh://user@example.com/hg/
関連記事: [:Serve], [:Push], [:Pull]
他の言語の翻訳: [:QuickStartDe:german] [:QuickStartPtBr:portuguese]