Международная локализация

Структура страницы

Wagtail хранит содержимое в отдельном дереве страниц для каждой языковой версии.

Например, если у вас два сайта на двух языковых версиях, то вы увидите четыре домашние страницы на верхнем уровне иерархии страниц в обозревателе.

Этот подход имеет некоторые преимущества для работы редактора:

• Нет языка по умолчанию для редактирования, поэтому содержимое может быть написано на любом языке, а затем переведено на любой другой.
• Переводы страницы — это отдельные страницы, поэтому их можно публиковать в разное время.
• Редакторам можно предоставить разрешение на редактирование содержимого на одной языковой версии и не на других.

Как регистрируются языковые версии и переводы в базе данных

У всех страниц (и любых фрагментов, для которых включён перевод) есть поля locale и translation_key:

• locale — внешний ключ к модели Locale
• translation_key — UUID, используемый для поиска переводов фрагмента содержимого. Переводы одной и той же страницы/фрагмента имеют одинаковое значение в этом поле.

Эти два поля имеют ограничение «уникальное вместе», поэтому у вас не может быть более одного перевода на одном языке.

Переведённые домашние страницы

При настройке сайта в Wagtail вы выбираете домашнюю страницу сайта в поле «Главная страница» и все запросы к корневому URL-адресу сайта будут перенаправлены на эту страницу.

На многоязычных сайтах есть отдельная домашняя страница для каждой языковой версии, которая существует как братская страница в дереве страниц. Wagtail находит другие домашние страницы, ища переводы главной страницы сайта.

Это означает, что чтобы сайт стал доступным на другом языке, вам нужно просто перевести и опубликовать его домашнюю страницу на этом языке.

Если Wagtail не может найти домашнюю страницу, соответствующую языку пользователя, он вернётся к странице, выбранной как «Главная страница» на записи сайта, поэтому вы можете использовать это поле для указания языка по умолчанию вашего сайта.

Обнаружение языка и маршрутизация

Для определения языка пользователя и добавления префикса к URL-адресам (например, /en/, /fr-fr/) Wagtail разработан для работы с встроенными утилитами интернационализации Django, такими как i18n_patterns и LocaleMiddleware. Это означает, что Wagtail должен беспрепятственно работать с другими интернационализированными приложениями Django на вашем сайте.

Языковые версии

Языковые версии, включенные на сайте, записываются в модели Locale в wagtailcore. Эта модель содержит всего два поля: ID и language_code, хранящий тег языка BCP-47, представляющий эту языковую версию.

Записи языковых версий можно настроить с помощью необязательного пользовательского интерфейса управления или создать в командной строке. Возможные значения поля language_code контролируются настройкой WAGTAIL_CONTENT_LANGUAGES

Включение интернационализации

Для включения интернационализации как в Django, так и в Wagtail, установите следующие настройки на True.

# my_project/settings.py

USE_I18N = True
WAGTAIL_I18N_ENABLED = True

Кроме того, возможно, вы захотите включить поддержку локализации Django. Это позволит отображать даты и числа в формате, соответствующем локали пользователя:

# my_project/settings.py

USE_L10N = True

Настройка доступных языков

Далее нам нужно настроить доступные языки. Для этого есть две настройки, каждая из которых используется для разных целей:

• LANGUAGES - это настройка, определяющая, какие языки будут доступны на переднем плане сайта.
• WAGTAIL_CONTENT_LANGUAGES - это настройка, определяющая, на каких языках можно создавать контент Wagtail.

Вы можете установить обе эти настройки в точное одинаковое значение. Например, чтобы включить английский, французский и испанский языки:

# my_project/settings.py

WAGTAIL_CONTENT_LANGUAGES = LANGUAGES = [
    ('en', "English"),
    ('fr', "French"),
    ('es', "Spanish"),
]

Вы также можете установить эти значения в разные значения. Возможно, вы захотите сделать это, если хотите иметь некоторую программную локализация (например, форматирование дат или валют), но использовать тот же контент Wagtail в нескольких регионах:

# my_project/settings.py

LANGUAGES = [
    ('en-GB', "English (Great Britain)"),
    ('en-US', "English (United States)"),
    ('en-CA', "English (Canada)"),
    ('fr-FR', "French (France)"),
    ('fr-CA', "French (Canada)"),
]

WAGTAIL_CONTENT_LANGUAGES = [
    ('en-GB', "English"),
    ('fr-FR', "French"),
]

При такой настройке сайт будет доступен на всех разных локалях в первом списке, но в Wagtail будет только две структуры языков.

Все en- локали будут использовать языковую структуру «Английский», а fr- локали — языковую структуру «Французский». Различия между каждой локалью в языке будут программными. Например: какой формат даты/числа использовать и какую валюту отображать в ценах.

Включение пользовательского интерфейса управления локалями (необязательно)

Доступно приложение для управления локалями, позволяющее администратору Wagtail настраивать локали через интерфейс Wagtail.

Для его включения добавьте wagtail.locales в INSTALLED_APPS.

# my_project/settings.py

INSTALLED_APPS = [
    # ...
    'wagtail.locales',
    # ...
]

Добавление префикса языка в URL-адреса

Для того чтобы все деревья страниц были доступны на одном домене, нам нужно добавить префикс URL-адреса для каждого языка.

Для этого мы можем использовать встроенную функцию Django i18n_patterns, которая добавляет префикс языка ко всем URL-образцам, переданным в неё. Это активирует код языка, указанный в URL, и Wagtail учитывает это при принятии решения о том, как обработать запрос.

В файле urls.py вашего проекта добавьте основные URL-адреса Wagtail (и любые другие URL-адреса, которые вы хотите перевести) в блок i18n_patterns.

# /my_project/urls.py

# ...

from django.conf.urls.i18n import i18n_patterns

# Non-translatable URLs
# Note: if you are using the Wagtail API or sitemaps,
# these should not be added to `i18n_patterns` either
urlpatterns = [
    path('django-admin/', admin.site.urls),

    path('admin/', include(wagtailadmin_urls)),
    path('documents/', include(wagtaildocs_urls)),
]

# Translatable URLs
# These will be available under a language code prefix. For example /en/search/
urlpatterns += i18n_patterns(
    path('search/', search_views.search, name='search'),
    path("", include(wagtail_urls)),
)

# myproject/settings.py

# ...

LANGUAGE_CODE = 'en'
WAGTAIL_CONTENT_LANGUAGES = LANGUAGES = [
    ('en', "English"),
    ('fr', "French"),
]

# ...

# myproject/urls.py
# ...

# These URLs will be available under a language code prefix only for languages that
# are not set as default in LANGUAGE_CODE.

urlpatterns += i18n_patterns(
    path('search/', search_views.search, name='search'),
    path("", include(wagtail_urls)),
    prefix_default_language=False,
)

- /search/
- /fr/search/

Автоопределение языка пользователя

После обертывания ваших URL-образцов с i18n_patterns, ваш сайт теперь будет реагировать на URL-префиксы. Но сейчас он не будет реагировать на корневой путь.

Для решения этой проблемы нам нужно определить язык браузера пользователя и перенаправить его на лучший префикс языка. Рекомендуемый подход — использовать LocaleMiddleware Django:

# my_project/settings.py

MIDDLEWARE = [
    # ...
    'django.middleware.locale.LocaleMiddleware',
    # ...
]

Настройка маршрутизации/определения языка

Вам не обязательно использовать i18n_patterns или LocaleMiddleware для этого, и вы можете написать свою собственную логику, если это необходимо.

Wagtail требуется только, чтобы язык был активирован (с помощью функции Django django.utils.translation.activate) перед вызовом представления wagtail.views.serve.

Выбор языка/региона

Возможно, самый важный элемент пользовательского интерфейса, связанный с интернационализацией, который вы можете добавить на свой сайт, — это селектор, позволяющий пользователям переключаться между различными языками.

Если вы не уверены, что вам это нужно, ознакомьтесь со статьёй https://www.w3.org/International/questions/qa-site-conneg#yyyshortcomings для обоснования.

{# make sure these are at the top of the file #}
{% load i18n wagtailcore_tags %}

{% if page %}
    {% for translation in page.get_translations.live %}
        {% get_language_info for translation.locale.language_code as lang %}
        <a href="{% pageurl translation %}" rel="alternate" hreflang="{{ language_code }}">
            {{ lang.name_local }}
        </a>
    {% endfor %}
{% endif %}

{% if page %}
    ...
{% endif %}

{% for translation in page.get_translations.live %}
    ...
{% endfor %}

{% get_language_info for translation.locale.language_code as lang %}

<a href="{% pageurl translation %}" rel="alternate" hreflang="{{ language_code }}">
    {{ lang.name_local }}
</a>

# myproject/settings.py

TEMPLATES = [
    {
        # ...
        'OPTIONS': {
            'context_processors': [
                # ...
                'django.template.context_processors.i18n',
            ],
        },
    },
]

{% for language_code, language_name in LANGUAGES %}
    {% get_language_info for language_code as lang %}

    {% language language_code %}
        <a href="{% pageurl page.localized %}" rel="alternate" hreflang="{{ language_code }}">
            {{ lang.name_local }}
        </a>
    {% endlanguage %}
{% endfor %}

{% for language_code, language_name in LANGUAGES %}
    ...
{% endfor %}

{% get_language_info for language_code as lang %}

{% language language_code %}
    ...
{% endlanguage %}

<a href="{% pageurl page.localized %}" rel="alternate" hreflang="{{ language_code }}">
    {{ lang.name_local }}
</a>

API-фильтры для сайтов без головной части

Для сайтов без головной части API Wagtail поддерживает два дополнительных фильтра для интернационализированных сайтов:

• ?locale= Фильтрует страницы по заданному языковому региону
• ?translation_of= Фильтрует страницы, чтобы включить только переводы данной страницы с заданным идентификатором

Для получения дополнительной информации см. Специальные фильтры для интернационализированных сайтов.

Переводимые фрагменты

Вы можете сделать фрагмент переводимым, сделав его наследником wagtail.models.TranslatableMixin. Например:

# myapp/models.py

from django.db import models

from wagtail.models import TranslatableMixin
from wagtail.snippets.models import register_snippet


@register_snippet
class Advert(TranslatableMixin, models.Model):
    name = models.CharField(max_length=255)

Модель TranslatableMixin добавляет поля locale и translation_key в модель.

# myapp/models.py

from django.db import models

from wagtail.models import BootstrapTranslatableMixin
from wagtail.snippets.models import register_snippet


@register_snippet
class Advert(BootstrapTranslatableMixin, models.Model):
    name = models.CharField(max_length=255)

    # if the model has a Meta class, ensure it inherits from
    # BootstrapTranslatableMixin.Meta too
    class Meta(BootstrapTranslatableMixin.Meta):
        verbose_name = 'adverts'

python manage.py makemigrations myapp --empty

from django.db import migrations
from wagtail.models import BootstrapTranslatableModel

class Migration(migrations.Migration):
    dependencies = [
        ('myapp', '0002_bootstraptranslations'),
    ]

    # Add one operation for each model to bootstrap here
    # Note: Only include models that are in the same app!
    operations = [
        BootstrapTranslatableModel('myapp.Advert'),
    ]

# myapp/models.py

from wagtail.models import TranslatableMixin  # Change this line

@register_snippet
class Advert(TranslatableMixin, models.Model):  # Change this line
    name = models.CharField(max_length=255)

    class Meta(TranslatableMixin.Meta):  # Change this line, if present
        verbose_name = 'adverts'

python manage.py makemigrations myapp
python manage.py migrate

Wagtail Localize

В рамках начальной работы по внедрению интернационализации в ядро Wagtail мы также создали пакет переводов под названием wagtail-localize. Он поддерживает перевод страниц в Wagtail, используя файлы PO, машинный перевод и внешнюю интеграцию с переводческими службами.

Github: https://github.com/wagtail/wagtail-localize