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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы включить интернационализацию в 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)),
)

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

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

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

# my_project/settings.py

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

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

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

Wagtail нужно только, чтобы язык был активирован (используя функцию django.utils.translation.activate Django) перед вызовом представления 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 core мы также создали пакет переводов под названием wagtail-localize. Он поддерживает перевод страниц в Wagtail, используя файлы PO, машинное переложение и внешнюю интеграцию с переводческими сервисами.

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