貢献する

このページではフランス語 (fr) を例として使用していますが、ほかの 言語コード へ置き換えられます。その場合は必ずこのガイドの /fr を翻訳の言語に置き換えてください!(訳注: 以下の各説明で "fr" と書かれたところを "ja" に読み換えてください。)

To see which languages are currently available, you can browse the repository: https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale

注釈

まず、マニュアルをビルドできることが前提です。まだビルドをしたことがない場合、Getting Started のセクションに戻ってください。

インストール

言語ファイル

チェックアウトフォルダーから次のコマンドを実行してください:

svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale/fr locale/fr

これで locale/fr のサブフォルダーが作られます。

このようなディレクトリのレイアウトになるはずです:

blender_docs
   |- locale/
   |  |- fr/
   |  |  |- LC_MESSAGES/
   |- manual/

注釈

When running subversion from the command line (such as updating or committing), you will need to change directory to locale/fr first.

Otherwise you will get a warning: 'locale' is not under version control

POファイルエディタ

POファイルを編集するにはPOエディタをインストールする必要があります。おすすめは Poedit ですが、どのPOエディタでも構いません。

注釈

Linuxユーザーの場合は、ディストリビューションのソフトウェアセンターでPoeditのバージョンを確認する必要があります。このエディタは単に推奨というだけです。他にKateやKwriteのように、構文の強調表示や大文字と小文字の入れ替えなど、テキスト編集のための基本的なツールを提供できるものがあります。他のプラットフォームでは、POファイルの構文強調表示をサポートしたり、(WindowsのNotepad ++などのように)カスタマイズできるエディタがあります。

翻訳のビルド

Now you can build the manual with the translation applied:

On Linux and macOS run:

make -e BF_LANG=fr

On Windows run:

set BF_LANG=fr
make html

これで翻訳されたマニュアルのビルドができました。(訳注: ちなみに上のコマンドを.batファイルにしておけば簡単に実行できます) 。

翻訳ファイルの編集

Now you can edit the PO translation files, e.g:

Original RST File

manual/getting_started/about_blender/introduction.rst

Generated PO File

locale/fr/LC_MESSAGES/getting_started/about_blender/introduction.po

The modified .po files can be edited and committed back to svn.

Commit Translation Files

See Submit Patches.

メンテナンス

ファジーストリングの管理方法

マニュアルがバージョンアップすると古い翻訳が fuzzy としてマークされます。管理するためのツールを使用してください。

次のコマンドを実行してください:

make report_po_progress

ただし、簡単な要約しか作られません。もっと情報が必要な場合には次を実行してください:

python tools_report/report_translation_progress.py locale/fr/

これで空のストリングとファジーストリングがあるすべてのファイルのリストが出ます。他のオプションを見るには:

python tools_report/report_translation_progress.py --help

POファイルのアップデート

元のファイルが更新されると、テンプレートを更新する必要があります。通常は管理者がすべての言語ファイルを一度に更新するため、これを行う必要がないことに注意してください。それによってマニュアルのすべての言語が同じバージョンになります。しかしながら、もしあなた自身で更新する必要がある場合には、以下を実行しても構いません:

make update_po

The updated templates can then be committed to svn.

参考

A guide how to add a new language can be found in the Adding a Language.