monospace blog

事の発端

すでに4ヶ月前になりますが、こんなものを作っていました。

[追記 2008/10/12] 以下の URL に patch をあてて、monoblue を試す方法を書きました。

http://blog.monospace.jp/2008/06/07/hgweb_design_template/

しばらく放置…ののち

PATCH 形式でくれっていわれて、すぐに送るつもりだったけど、hgwebにグラフ機能がついたり、直す箇所とかもあって放置していたら、すでに10月でした。とあるメールがきっかけで勢いで作ってパッチを送ったんですが、見事に失敗…Mercurial Developers の ML にゴミを残してしまいました。

問題のポイント

Mercurial Developers の ML はいつも見てるので、パッチを送る場合は、[PATCH]とか複数の場合は[PATCH 1 of 3]みたいな感じで送ればいいんだなと認識してたので、そういう感じで作ってみました。今回のパッチは、すべてのファイルが新規ファイルで、10個以上のHTMLとCSSを含んでいるので行数にすると1400行くらいです。これをメールの本文に貼るのは、つらいと思っていくつかに分割してみました。(そもそもこれが間違いで、分割するのはChangesetが分かれてるときだけっぽい)。で、手動で3つに分けてGmailから送信。

なぜ分割したかという言い訳をちょっとしておくと、最初に1400行のまま送ったパッチがどうやら送信されなかったっぽい？ので容量オーバーかと思ったわけです。

ご教授頂く

自分が送ったパッチを見てくれた方が、Gmailからの送信のときに改行でおかしくなってるよと指摘してくれて、↓の Patchbomb という拡張機能を教えてくれました。この機能を見てちょっとはずかしくなったわけです。どうやら[PATCH 1 of 3]っていうのは、手動でやってるわけじゃなくて、この拡張を使うと勝手に changeset に分けてそういうメールを作って送ってくれるみたいなんです。使ってみてちょっと感動しました。

http://www.selenic.com/mercurial/wiki/index.cgi/PatchbombExtension

Twitter で長い URL を載せるときに自分で TinyURL に行って短い URL にして貼っていたのを思い出しました。勝手にやってくれるのを知ったときも衝撃でしたね。

パッチの問題はいろいろあるっぽい？

こんだけ大量のパッチがとびかってるとそりゃー大変でしょうね。↓こんなのがあがってました。パッチを送るときの心得みたいなものがのってます。本文にインラインで入ってるのが望ましいっていうのがちょっと意外だったんだけど、大量のパッチをさばくとなるとその方が楽なのかな。添付だと確かに開く手間がちょっとあるし。

http://www.selenic.com/mercurial/wiki/index.cgi/SuccessfulPatch

というわけで

Mercurial を使ってるプロジェクトでパッチをやりとりするならこの方法なのかな。本家がやってるくらいだから推奨なんでしょうね。

で、自分のパッチが採用になるかは分かりませんが、特にすごい技術力がなくても(たいしたデザインもしてないし、HTMLとCSS書いただけ)こうやってオープンソースのプロジェクトに参加できるんだなってことが分かったし、いろいろと勉強になります。英語とかも。目指せ世界進出。

monoblue の使用方法

とりあえず簡単に試す方法(とおもったら割と面倒？)。 Mercurial がインストールされているのが前提です。

Mercurial の trunk を clone します。

$ hg clone http://selenic.com/repo/hg/

monoblue の patch をダウンロード。

<a href="http://dl.getdropbox.com/u/97681/monoblue.patch">monoblue パッチをダウンロード</a>

monoblue.patch というファイルが保存されると思いますので、パッチのインポートを行ってください。 mercurialのリポジトリに移動して、以下のコマンドを実行します。

$ hg import /path/to/monoblue.patch

パッチあてた版をインストール

$ python setup.py install

Mercurial で管理しているプロジェクトの .hg/hgrc に以下を追加

[web]
style = monoblue

hgweb をローカルホストで実行。

$ hg serve

これで、 http://localhost:8000 にアクセスすると見れます。もしくは、.hg/hgrc に書かなくても、http://localhost:8000/?style=monoblue でもいけるかも。

多分以上です。 ライセンスは、Mercurial が GPL だから GPL ということで。