Accept cookies for analytics, social media, and advertising, or learn more and adjust your preferences. These cookies are on by default for visitors outside the UK and EEA. Privacy Notice.
このドキュメントは例としてロシア語への変換を使用します。他の言語については、ru
を適切な言語コードに置き換えてください。
標準のpython-sphinx
ツールに加えて、変換のために必要とされるファイルを構築するためにsphinx-intl
ツールが必要です。インストールするためにこのコマンドを実行します:
$ sudo pip install sphinx-intl
翻訳可能なメッセージはgettext
を使って抽出されます:
$ make gettext
これらはローカルファイルを言語ファイルを更新するために使われなければなりません:
$ sphinx-intl update -p build/locale -c source/conf.py -l ru
上のように一旦更新すると、source/locale/ru/LC_MESSAGES
の中に変換ソースファイルを見つけることができます。.po
拡張子を持つ各ファイルには、msgid
および msgstr
と呼ばれるエントリーがあります。msgid
には英語が含まれ、msgstr
には翻訳を配置します。もっと多くの内容が必要な場合、各エントリーは元となるソースファイルと行を言及するでしょう。
コミットする時には、翻訳がソースと一緒に格納されるように、.po
ファイルがGitHubに追加されなければなりません。
Wikiの翻訳バージョンは以下を使って構築されます:
$ sphinx-intl build -c source/conf.py
$ make -e SPHINXOPTS="-D language='ru'" html
変換された出力は build/html
に書き込まれます。