目次

このページでは、Mercurialの使用方法について説明します。
各項目をクリックすると、該当の位置へ移動します。

Mercurialとは

Mercurial(マーキュリアル)は、クロスプラットフォームの分散型バージョン管理システムです。

yomitan:/home/hg

に皆さんのリポジトリ用スペースが用意されています。
ここのリポジトリの内容はMercurial閲覧のページで確認することができます。

Mercurialの使い方

Homebrewをインストールする

まず、HomebrewでMarcurialをあなたのパソコンにインストールしてください。
また、ターミナルでインストールすることもできます。

sudo brew install mercurial

localからremoteへリポジトリを作る場合

送りたいファイルのあるディレクトリで

hg init

これをすると .hg というディレクトリが作成されているはず

ls -a

で確認できます.

あとは送りたいファイルを add して commit して clone するだけです.

hg add [送りたいファイル]
hg commit -m '何かコメント'
hg clone . ssh://yomitan.ie.u-ryukyu.ac.jp//home/hg/yxx/exx57xx/リポジトリ名 (下記を参考にxxの部分は適宜変更してください)

(2020年入学、学籍番号e205799の場合)
(例) hg clone . ssh://yomitan.ie.u-ryukyu.ac.jp//home/hg/y20/e205799/リポジトリ名)

push したいときは

hg push ssh://exx57xx@yomitan.ie.u-ryukyu.ac.jp//home/hg/yxx/exx57xx/リポジトリ名

毎回 ssh://~ を書くのがめんどくさいときは, localにあるリポジトリの .hg/hgrc に下記を追加する.

[paths]
default = ssh://e1x57xx@yomitan.ie.u-ryukyu.ac.jp//home/hg/y1x/e1x57xx/リポジトリ名

remoteでリポジトリを作ってからlocalにcloneする場合

次に、yomitan:/home/hg/yxx/exx57xx/フォルダにhogeというフォルダをレポジトリとして使用する場合、sshでyomitanに入り、/home/hg/yxx/exx57xx/hogeのフォルダまで移動し、リポジトリを作成します。

ssh exx57xx@yomitan.ie.u-ryukyu.ac.jp

Password:

[yomitan:~] exx57xx% cd /home/hg/yxx/exx57xx/hoge
[yomitan:hg/yxx/exx57xx/hoge] exx57xx% hg init

次に、/home/hg/yxx/exx57xx/hogeに用意したリポジトリの内容をあなたのパソコンでも編集できるように、あなたのパソコンにリポジトリを複製します。

ssh経由でhgコマンドを使用するので、あなたのyomitanのホームディレクトリにある.ssh/environmentを編集し(無ければ作成)、ssh経由用にhgのパスを通してあげる必要があります。

ssh exx57xx@yomitan.ie.u-ryukyu.ac.jp

Password:

[yomitan:~] exx57xx% cd  .ssh

[yomitan:~/.ssh] exx57xx% vi environment

//environmentに記入

PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

これでssh経由でのhgのパスを通すことができました。
次のように入力することで、リポジトリを複製することができます。

hg clone ssh://exx57xx@yomitan.ie.u-ryukyu.ac.jp//home/hg/yxx/exx57xx [directory name]

リポジトリの中にリポジトリを作成してしまうと,、ブラウザ上から見えるのは1番上になるディレクトリとなるため注意してください。

複製したリポジトリを編集する

ディレクトリ、ファイルをレポジトリに追加

hg add (file name)

リポジトリに反映させるためにcommit

hg commit

リポジトリに反映されていない情報を破棄して元に戻す

hg revert

前回のバージョンからの変更されたファイルの確認

hg status

前回のバージョンからの変更されたファイルの変更点の確認

hg diff

作業の更新履歴

hg log

編集したリポジトリを反映・公開する

あなたのパソコンで編集したリポジトリの内容は、/home/hg/yxx/exx57xx/のリポジトリにはまだ反映されていません。
編集した内容を反映し公開するには hg push を実行します。

hg push

上記のコマンドを実行することで、/home/hg/yxx/exx57xx/のリポジトリに情報を反映させることが出来ます。
ただし、このままだと yomitan のワーキングディレクトリは変更されないので、それを表示するには yomitan側の/home/hg/yxx/exx57xx/で、下記のコマンドを実行する必要があります。

hg update

これで/home/hg/yxx/exx57xx/の中に変更したファイルが表示される様になります。
また、これを行わない場合バイナリファイル(pdf 等)はMercurial閲覧で見る事ができません。