#language ja #pragma section-numbers 2 = Mercurial の国際化 = このページでは、 Mercurial のメッセージを得意な言語に翻訳することで Mercurial の国際化を手伝う方法を説明しています。 Mercurial では標準的な国際化ライブラリ [[http://www.gnu.org/software/gettext/|Gettext]] を利用しており、ここでその詳細は説明しません。 ソフトウェアの翻訳に不慣れな方は、Gettext のマニュアルをご覧ください。 <> == 翻訳を始める == Mercurial が使い慣れた言葉に訳されていないと分かれば、翻訳を始めるチャンスです。 まず、その言語への翻訳が進行していないことを、このページの最後を見るか、開発用 MailingList に問い合わせるかして確認しましょう。 [[http://www.transifex.net/projects/p/mercurial/|Transifex]] リストもあります。 翻訳メッセージは ''`i18n/`'' ディレクトリの ''`xx.po`'' か ''`xx_yy.po`'' というファイルに保存されます。 `xx` は言語コードに、 `yy` は国コード(省略可)に対応しています。言語コードは [[http://www.gnu.org/software/gettext/manual/html_node/Usual-Language-Codes.html|ISO 639-1 一覧]] から、また、国コードは必要であれば [[http://www.gnu.org/software/gettext/manual/html_node/Country-Codes.html|ISO 3166 list]] から取得できます。 Most translations only use a language code. 翻訳を新規に始めるには、まず ''`i18n/hg.pot`'' ファイルを作成します。 Makefile で作成しましょう: {{{ % make update-pot }}} 次に、 ''`hg.pot`'' から翻訳メッセージファイルを作成します。 `msginit` コマンドを使うか、 ''`hg.pot`'' ファイルを適当な ''`xx.po`'' にコピーするかして翻訳を始めます。 If you copy it by hand, please set the `Language` header to `xx`. それでは、 ''`xx.po`'' ファイルを好みの PO エディタ([[http://www.poedit.net/|Poedit]] や Emacs 、あるいは [[https://www.google.com/search?q=po+editor|some other PO editor]] など)で編集しましょう。 ''`xx.po`'' ファイルは普通のテキストエディタ(!WordPad など)でも編集できますが、その場合はフォーマットを崩さないように注意しなければなりません。 翻訳メッセージを適用するには、 ''`xx.po`'' ファイルを ''`xx.mo`'' へコンパイルする必要があります。 `msgfmt` コマンドがインストールされていれば、次のようにしてコンパイルできます: {{{ % python setup.py build_mo }}} 別の方法として、 Poedit などの PO エディタでコンパイルすることも可能です。その場合、 ''`hg.mo`'' というファイルが生成されるはずですので、それを次の場所に保存してください。 {{{ locale/xx/LC_MESSAGES/hg.mo }}} ''`setup.py`'' を使うと、このファイルは自動的にできます。 ''`xx.po`'' を手動でコンパイルした場合は、ディレクトリ構造を自分で準備しなければなりません。 では、 `LANGUAGE` 環境変数を確実に `xx` へセットしましょう。 Bash系のシェルであれば、次のようにしてください: {{{ % export LANGUAGE=xx }}} それから、 `hg` コマンドを実行し、翻訳メッセージが選択されているか確かめます。 == 翻訳を更新する == /!\ 翻訳用の作業リポジトリが分かれている場合があります。 適切なリポジトリをクローンしたことを確認してから取りかかりましょう。 Mercurial のソースコードに変更が加わると、翻訳すべきメッセージが出てきます。 これらは現状の翻訳メッセージへ簡単に反映できます: 前述の方法で ''`hg.pot`'' を再生成し、 `msgmerge` コマンドで新しく加わったメッセージを翻訳メッセージへマージするだけです: {{{ msgmerge --no-location --update i18n/xx.po i18n/hg.pot }}} po ファイルを make しても同じです。 {{{ make i18n/xx.po }}} ''`hg.pot`'' の再生成と `msgmerge` を一続きに実行しています。 それでは、新規のメッセージを訳して、 ''`xx.mo`'' ファイルを作りますか。 When you commit the updated translation, use {{{ i18n-xx: synchronized with NODE }}} where `NODE` is either the changeset hash of your working copy parent revision before the commit or (better) the hash of its most recent ancestor that changed a translated message. 翻訳中にファイル名と行番号を残しておきたい場合は、上記コマンドを {{{--no-location}}} フラグなしで実行してください。 ファイル名と行番号が ''`hg.pot`'' から ''`xx.po`'' へマージされ、ソースコードの特定箇所にジャンプし易くなります。 ただし、ムダな差分ができてしまうため、翻訳のコミット前にはファイル名と行番号を取り除かなければなりません。 {{{ msgcat --no-location -o xx.po xx.po }}} パッチに不要な変更が含まれていないか、 '`hg diff`' でチェックする習慣をつけてください。 == 提出 == 別の翻訳を始めるにあたっては、 MartinGeisler へお知らせください。 {{{irc.freenode.net}}} の {{{#mercurial}}} (contact {{{mg}}}) へ参加し、翻訳を pull 可能な URL を提供するのが簡単です。 そうすると、変更点は彼の手で [[http://bitbucket.org/mg/hg-i18n/|i18n queue]] へ push され、ゆくゆくはメインリポジトリへ pull されます。 変更点は '''stable''' ブランチへコミットしなくてはならないので、まず stable ブランチへ更新してください。 翻訳の変更点は(遅くても 1 ヶ月後の)次のリリースに反映されますから、ユーザにすぐに届いて、上手く行けば意見をもらえるかもしれませんね。 /!\ '''ブランチ間のマージは絶対にしないでください。''' 不用意にコードの変更点を伝搬してしまいますから。 Your commit messages should have this format: {{{ i18n-xx: short description }}} For a new translation, the first changesets could look like this: {{{ i18n-xx: new translation i18n-xx: translated add, log, diff i18n-xx: translated status }}} Please rebase your changesets on top of the stable branch before pushing them to the hg-i18n repository (use '`hg rebase`'). That will keep the number of merges to a minimum and simplify the history graph. In general, your working cycle can look like this: * modify ''`xx.po`'' and commit it (in your `xx` repository) * once in a while (especially before pushing), do a '`hg pull --rebase`' * run '`make local`' to rebuild the ''`.mo`'' files * test your translation with '`./hg`' (make sure first that `$LANGUAGE` equals `xx`) * run '`make test-gendoc.t`' to make sure that you don't introduce reStructuredText syntax errors (you will need docutils for that, e.g. package {{{python-docutils}}} in Debian/Ubuntu) * when you are happy with your translation push it to hg-i18n == フォーマット == コマンドヘルプを翻訳する時は、半角78文字で折り返す必要があります。次のパターンに従ってください: {{{ 簡単な説明、小文字始まり コマンドの詳しい説明。各段落は4文字分インデントし、半角70文字で折り返す 必要があります。 段落は空行1つで区切ります。 文の区切りには半角空白を1文字を入れます。 }}} == アドバイス == 便利なワザをここに載せてください。 === Possible repository setup === Although you can use any repository to keep track of your translation progress, the following setup may prove handy: * create a Bitbucket repository by forking the [[http://bitbucket.org/mg/hg-i18n/|i18n queue]]; you need a [[http://bitbucket.org/|Bitbucket]] account for that * clone that repository on your machine * work on the clone: edit, commit, pull changes from the [[http://bitbucket.org/mg/hg-i18n/|i18n queue]] with `hg pull --rebase` (that also updates your local repository) * push your changes to the fork repository * let MartinGeisler know where your fork lies, and he'll push the changes to the [[http://bitbucket.org/mg/hg-i18n/|i18n queue]] When you will have the rights to do it, you will be able to push your changes directly to [[http://bitbucket.org/mg/hg-i18n/|i18n queue]] (and you may discontinue your fork, if you wish so). === TortoiseHg から文字列を取り込む === [[http://bitbucket.org/tortoisehg/stable/wiki/Home|TortoiseHg]] プロジェクトでは多数の翻訳がなされており、その文字列のうち50個ほどが Mercurial と重複しています。 メッセージを流用するには、まず、最新の翻訳をダウンロードします。 URL は次の形式です: {{{ http://bitbucket.org/tortoisehg/stable/raw/tip/i18n/tortoisehg/xx.po }}} {{{wget}}} かブラウザでダウンロードし、 ファイルを {{{i18n}}} フォルダーに保存します。その後、共通な翻訳メッセージを抽出します。 {{{ msgcomm tortoisehg-xx.po hg.pot -o common-xx.po }}} ''`tortoisehg-xx.po`'' を間違いなく前側に指定してください。翻訳メッセージは前側に指定したファイルから取り出されます。最後に、{{{msgcat}}} でファイルを一つにまとめます。 {{{ msgcat --no-location hg.pot common-xx.po xx.po -o xx.po }}} ''`hg.pot`'' を指定することで、メッセージの順番が変わらないようにしています。 翻訳の一部がプロジェクト同士で衝突することがあります。衝突は ''`xx.po`'' ファイルへ次のように記録されます。 (ドイツ語訳の例) {{{ msgid "unrecognized response\n" msgstr "" "#-#-#-#-# de.po (Mercurial) #-#-#-#-#\n" "Unbekannte Antwort\n" "#-#-#-#-# tortoisehg-de.po (tortoisehg) #-#-#-#-#\n" "nicht erkannte antwort\n" }}} ''`xx.po`'' を読んで衝突を解消する必要があります。上記の例では、Mercurial 側で "Unbekannte Antword" と訳したメッセージを、 TortoiseHg では "nicht erkannte antwort" と訳しています。 "{{{#-#-#-#-#}}}" とマークされた行を削除し、どちらか好きな方の翻訳のみを残してください。 TortoiseHg の訳者と連絡を取り、訳語を揃える努力をしましょう。今後の流用がお互い楽になります。 === 頻度の高いメッセージから訳す === 重要なメッセージから翻訳したい場合は、 [[http://bitbucket.org/mg/hg-i18nstat/|i18nstat エクステンション]]を使ってみるといいかもしれません。 このエクステンションでは翻訳メッセージのログを取り、未翻訳のメッセージが使われた回数を数えています。 必要なことは、このエクステンションを有効にし、普通に Mercurial を使うだけです。累積データをダンプするには '`hg i18nstat`' コマンドを使います。 未翻訳のメッセージを翻訳すると、次にそのメッセージが使われた時に累積データから取り除かれます。(メッセージが使われるまで、このエクステンションは翻訳されたことを検知しません。) == 既存の翻訳 == Mercurial と一緒に配布されている翻訳メッセージ ([[http://www.transifex.net/projects/p/mercurial/|Transifex]] リストもご覧ください): * [[BrazilianPortugueseTranslation|Brazilian Portuguese]] (WagnerBruna) * [[CzechTranslation|Czech]] (Tovim) * [[DanishTranslation|Danish]] (MartinGeisler) * French Mercurial (CedricDuval) -- repository: https://bitbucket.org/cedric/mercurial-l10n-fr/ (same mailing list as for the French hgbook) * [[GermanTranslation|German]] * [[GreekTranslation|Greek]] (GiorgosKeramidas) * Italian (StefanoTortarolo) -- Development takes place at http://bitbucket.org/astratto/hg-i18n-it/ * Japanese (KatsunoriFujiwara) -- Development takes place at http://bitbucket.org/foozy/mercurial-translation-ja/ * [[TranslatingMercurialIntoRussian|Russian]] (AlexanderSauta) -- Development takes place at https://bitbucket.org/demosito/hg-i18n-ru * [[RomanianTranslation|Romanian]] (DanielDumitriu) -- Development takes place at http://bitbucket.org/dumitriu/hg-i18n-ro/ * Simplified Chinese (DongshengSong) -- Development takes place at http://bitbucket.org/dongsheng/hg-i18n/ * Traditional Chinese (ChiaHuanWu) -- Development takes place at https://bitbucket.org/hgcht/hg-cht-translation まだ Mercurial と一緒に配布されていない翻訳: * French hgbook (RomainPelisse) -- patch queue: http://bitbucket.org/rpelisse/hgbook-fr/ , dedicated mailing list : http://groups.google.com/group/hgfr (obviously, the mailing list is in French :) ). We created a dedicated page to help organize our work : (FrenchTranslation). * ''新しい翻訳へのリンクはここに追加して!'' 特定の言語の翻訳に参加したい時は、上記の方に連絡してください。別の翻訳を始めたい場合は、その言語とあなたの名前をリストに追加してから進めてください。 ---- CategoryJapanese [[TranslatingMercurial|English]]