貢献する

このページでは日本語 (ja) が例として使われています。ただし、ほかの 言語コード でも使えます。そういう場合は必ずこのガイドの /ja を翻訳の言語に置き換えてください！

選択できる言語を見るにはリポジトリを見てください： 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/ja のサブフォルダーが作られます。

この通りのレイヤウトが見えるはずです：（※日本語の場合 /jaがあるはずです）

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

注釈

SVNのコマンド（例えば svn updateやsvn commit）をコマンドライン(cmd.exe)から使いたい場合はまずフォルダーを locale/jp に変える必要があります。

そうしないとエラーが出ます： 'locale' is not under version control

POファイルエディタ

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

注釈

For Linux users, you will have to check with your distribution's software center for a version of Poedit. This editor is only a recommendation. There are others, such as Kate and Kwrite, that could offer syntax highlighting and basic tools for text editing, e.g. letter case transposes. Other platforms can use some text editors supporting the syntax highlighting for PO files, or allowing you to create a custom one (such as Notepad++ on Windows).

翻訳のビルド

注釈

任意です。翻訳がオンラインで自動的にビルドされます、例： https://docs.blender.org/manual/ja/dev/

翻訳したマニュアルをビルドしてみましょう：

make -e SPHINXOPTS="-D language='fr'"

If you are on Windows and do not have make, run:

sphinx-build -b html -D language=fr ./manual ./build/html

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

翻訳ファイルの編集

これでPOファイル（翻訳ファイル）を編集できます：

ソースファイルのRSTファイル

manual/getting_started/about_blender/introduction.rst

生成されたPOファイル

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

編集された .po ファイルをコミットすることによってマニュアルが編集できます。

Commit Translation Files

See Submit Patches.

メンテナンス

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

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

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

make report_po_progress

ただし、簡単な要約しか作られません。もっと情報が要る場合は：

python tools/report_translation_progress.py locale/fr/

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

python tools/report_translation_progress.py --help

参考

このページの情報が Sphinx Intl documentation に基づいています

Updating PO Files

As the original manual changes, the templates will need updating. Note, doing this is not required, as administrator usually update the files for all languages at once. This allows all languages to be on the same version of the manual. However, if you need to update the files yourself, it can be done as follows:

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.