言語設定の有効化

デフォルトの言語と利用できる言語のリストを定義するために、まずsettings.pyファイル内で以下例のように言語設定を有効にします。

from django.utils.translation import gettext_lazy as _

LANGUAGE_CODE = 'ja'  # デフォルトの言語設定
LANGUAGES = [
    ('ja', _('Japanese')),
    ('en', _('English')),
    # 他の言語を追加
]

多言語の設定を完了した後、次にコード内で多言語対応したい箇所で翻訳のコードを書き込みます。
対応する箇所のファイルタイプによって、コードの書き方は少々違いがあります。

テンプレートの多言語対応

テンプレート内のテキストを多言語対応する必要がある場合、つまりHTMLファイルで多言語対応する場合、{% trans %} テンプレートタグを使用してテキストを翻訳します。

{% load i18n %}

<h1>{% trans "Multilingual Sample" %}</h1>
<p>{% trans "This is a sample code for multilingual support." %}</p>

Pythonコードの多言語対応

多言語対応は、Pythonコード内でも活用できます、以下の例のようにdjango.utils.translationには翻訳用の関数を用意しております。

# models.py
from django.db import models
from django.utils.translation import ugettext
from django.utils.translation import ugettext_lazy as _

SAMPLE_DATA = [
    {'key': 'sample', 'text': ugettext('Sample')},
]

class Sample(models.Model):
    sample = models.CharField(_('Sample'), max_length=50)

ここでugettextとugettext_lazyの二つの関数を利用しました、両者の違いは以下です。

ugettext_lazy

テンプレートやモデルのフィールドといった遅延評価が必要なコンテキストで使用されます。
文字列を翻訳せず、文字列そのものをラップし、テンプレートがレンダリングされる際やモデルのデータがクエリされる際に翻訳を遅延させます。これにより、適切な言語が選択され、ユーザーに表示されるまで待つことができます。

ugettext

翻訳を即座に評価する関数です。文字列を翻訳し、その結果を返します。
主にPythonコード内で使用され、静的なテキストやメッセージを翻訳するのに適しています。

JavaScriptコードの多言語対応

多言語対応は、JavaScriptコード内でも活用できます。

var text = gettext('Sample Text');

翻訳メッセージの設定

アプリケーション内のテキストを翻訳可能にするために、翻訳メッセージを設定します。以下コマンドを実行します。

python manage.py makemessages -l ja
python manage.py makemessages -l en

これで/local/ja/と/local/en/がそれぞれ作成されます。

しかしこれだけでJSファイルの中の翻訳が追加されません、そのために以下コマンドを実行します。

django-admin.py makemessages -d djangojs -l ja
django-admin.py makemessages -d djangojs -l en

これでpublicの下に/local/ja/と/local/en/がそれぞれ作成されます。

以上コマンドで作成した.poファイルを編集し、翻訳後の文言を入れた後、以下コマンドを実行します。

python manage.py compilemessages

これで.poファイルから.moファイルが作成されて、翻訳メッセージとして利用できます。

言語切り替えの実装

ユーザーが言語を切り替えられるように、テンプレートに言語切り替え機能を実装します。

<!-- templates/base.html -->
{% load i18n %}

<div id="language-switcher">
    <a href="?language=ja" class="{% if request.LANGUAGE_CODE == 'ja' %}active{% endif %}">日本語</a>
    <a href="?language=en" class="{% if request.LANGUAGE_CODE == 'en' %}active{% endif %}">English</a>
    <!-- 他の言語を追加 -->
</div>

ここでactiveクラスに対して、CSSなどを編集すると、スタイル違いやクリックできないようにすることなどで、現行の言語と表記できます。

まとめ

Djangoを使用して多言語対応のウェブアプリケーションを構築する方法を詳しく説明しました。多言語対応は、ユーザーエクスペリエンスを向上させるために不可欠な要素です。この記事がお役に立てれば幸いです。

Djangoで多言語対応を実現する方法