この記事では、Pythonの翻訳機能について記載します。

GNU gettext

Djangoの多言語機能を使うためには、GNU gettextパッケージが必要。
gettextパッケージは、Pythonだけではなく、他の言語等でも使用されている。

gettext モジュールは、 Python のモジュールやアプリケーションの国際化 (I18N, I-nternationalizatio-N) および地域化 (L10N, L-ocalizatio-N) サービスを提供します。 このモジュールは GNU gettext メッセージカタログの API と、より高水準で Python ファイルに適しているクラス形式の API の両方をサポートしてます。
`https://docs.python.org/ja/3/library/gettext.html#module-gettext`

このパッケージには、標準で翻訳に使えるメソッドが豊富にある。
以下の公式ドキュメントに、以下のように各メソッドについての詳細が記載されている。

gettext.gettext(message)
現在のグローバルドメイン、言語、およびロケールディレクトリに基づいて、 message の地域化された訳文を返します。 通常、この関数はローカルな名前空間にある _() という別名を持ちます (下の例を参照してください)。
`https://docs.python.org/ja/3.7/library/gettext.html`

po、mo、potファイルについて.

翻訳を行うにあたって、以下のファイルを使用する必要がある。

.potファイル
poの元になるファイル(テキストファイル)
.poファイル
potファイルに翻訳文を記入したファイル
.moファイル
poファイルからgettextにより作成されたバイナリファイル。

poファイル

msgid "this is a string"
msgstr "これは文字です"

msgidに翻訳文の元。
msgstrに翻訳後の文。

gettextなどで、.poから.moを作成する。

作業手順

gettextのインストール
設定変更
settings.pyに設定を追加する。

LANGUAGE_CODE = 'ja'

LOCALE_PATHS = (
    os.path.join(BASE_DIR, 'locale'),
)

3.ローケルファイル作成
workspaceにおいては、以下にファイルがある。

workspace
- locale
 - en
  - LC_MESSAGES
   - django.mo
   - django.po
 - ja
  - LC_MESSAGES
   - django.mo
   - django.po

4.ローケルファイルの編集とコンパイル
.poファイルに追加したい翻訳を追加などする。
そして、以下のコマンドを実行する。

docker-compose run server python manage.py compilemessages -l ja
docker-compose run server python manage.py compilemessages -l en