Sphinx による記事の翻訳手順

1. 元になる記事を日本語で作成、更新します

2. pot ファイル(カタログ)を更新します

$ cd docs
$ sphinx-build -M gettext . _pot

. から _pot フォルダに翻訳カタログを作成。

_pot は .gitignore しています。

vscode例: https://github.com/vrm-c/vrm.dev/blob/master/.vscode/tasks.json#L16

3. pot から po ファイル(翻訳表)を自動生成します

$ cd docs
$ sphinx-intl update -p _pot/gettext -l en

po は docs/locale に作成されます。

• -p で _pot ファイルの在りかを指定します。
• -l で作成する po の言語を指定します。

vscode例: https://github.com/vrm-c/vrm.dev/blob/master/.vscode/tasks.json#L25

4. po に翻訳を記述します

po は docs/locale に記事と同じ木構造で、 .po ファイルが有るので更新してコミットしてください。

https://github.com/vrm-c/vrm.dev/tree/master/docs/locale/en/LC_MESSAGES