Краткое руководство по Django I18n

Узнайте, как легко выполнять перевод и локализацию в Django, популярной веб-среде Python.

Мы должны сделать перевод вашего веб-приложения на разные языки и добавить правильную локализацию! Из этого туториала вы узнаете, как начать процесс локализации в Django. Часть этого может быть легко применена к общей локализации Python, и мы также покажем вам, как вы можете еще больше ускорить рабочий процесс i18n с помощью Phrase .

Мы предполагаем, что у вас есть работающее приложение Django и вы установили gettext (например, через pip install gettext). Если вы раньше не пользовались Django, вы можете сначала взглянуть на официальный учебник и вернуться позже.

Основные настройки

Итак, давайте предположим, что у вас есть проект Django mysiteи приложение polls. Структура вашего проекта должна выглядеть примерно так: 

/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    polls/
        migrations/
        __init__.py
        admin.py
        models.py
        tests.py
        views.py

# mysite/settings.py

LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'

USE_I18N = True
USE_L10N = True
USE_TZ = True

<!-- polls/templates/polls/index.html -->

<h1>Welcome to our site!</h1>
<p>Here you find polls.</p>

<!-- polls/templates/polls/index.html -->

{% load i18n %}

<h1>{% trans 'WelcomeHeading' %}</h1>
<p>{% trans 'WelcomeMessage' %}</p>

# polls/views.py

from django.http import HttpResponse
from django.utils.translation import ugettext as _

def index(request):
    output = _('StatusMsg')
    return HttpResponse(output)

$ django-admin makemessage -l de

# polls/locale/de/LC_MESSAGES/django.po

...

#: templates/polls/index.html:3
msgid "WelcomeHeading"
msgstr ""

#: templates/polls/index.html:4
msgid "WelcomeMessage"
msgstr ""

# polls/locale/de/LC_MESSAGES/django.po

...

#: templates/polls/index.html:3
msgid "WelcomeHeading"
msgstr "Willkommen auf unserer Seite!"

#: templates/polls/index.html:4
msgid "WelcomeMessage"
msgstr "Hier findet Ihr Umfragen."

$ django-admin compilemessages

# mysite/settings.py

LANGUAGE_CODE = 'de'

# .phraseapp.yml

phraseapp:
  access_token: <your access token>
  project_id: <your project's id on PhraseApp>
  file_format: po

  pull:
    targets:
        file: "polls/locale/<locale_code>/LC_MESSAGES/django.po

$ phraseapp pull && django-admin compilemessages

$ pip install django-phrase

<!-- polls/templates/polls/index.html -->

{% load i18n %}
{% load phrase_i18n %}
{% phrase_javascript %}

<h1>{% trans 'WelcomeHeading' %}</h1>
<p>{% trans 'WelcomeMessage' %}</p>

# mysite/settings.py

PHRASE_ENABLED = True
PHRASE_PROJECT_ID = 'YOUR_PROJECT_ID'
PHRASE_PREFIX = '{{__'
PHRASE_SUFFIX = '__}}'

# mysite/settings.py

from django.utils.translation import ugettext_lazy as _

...

MIDDLEWARE_CLASSES = (
    ...,
    'django.middleware.locale.LocaleMiddleware',
    ...,
)

...

LANGUAGE_CODE = 'en-us'

LANGUAGES = (
    ('en-us', _('English')),
    ('de', _('German')),
)

$ curl http://localhost:8000/polls -H "Accept-Language: de"

<h1>Willkommen auf unserer Seite!</h1>
<p>Hier findet Ihr Umfragen.</p>