국제화¶

페이지 구조¶

Wagtail은 각 로케일에 대해 별도의 페이지 트리에 콘텐츠를 저장합니다.

예를 들어, 두 로케일에 두 개의 사이트가 있는 경우 탐색기에서 페이지 계층 구조의 최상위 수준에 네 개의 홈페이지가 표시됩니다.

이 접근 방식은 편집자 경험에도 몇 가지 이점이 있습니다.

• 편집을 위한 기본 언어가 없으므로 콘텐츠를 어떤 언어로든 작성한 다음 다른 언어로 번역할 수 있습니다.

• 페이지의 번역은 별도의 페이지이므로 다른 시간에 게시할 수 있습니다.

• 편집자에게 한 로케일의 콘텐츠를 편집할 수 있는 권한을 부여하고 다른 로케일의 콘텐츠는 편집할 수 없도록 할 수 있습니다.

로케일 및 번역이 데이터베이스에 기록되는 방식¶

모든 페이지(및 번역이 활성화된 모든 스니펫)에는 locale 및 translation_key 필드가 있습니다.

• locale 은 Locale 모델에 대한 외래 키입니다.

• translation_key 는 콘텐츠의 번역을 찾는 데 사용되는 UUID입니다. 동일한 페이지/스니펫의 번역은 이 필드에 동일한 값을 공유합니다.

이 두 필드에는 ‘고유 제약 조건’이 있으므로 동일한 로케일에 두 개 이상의 번역을 가질 수 없습니다.

번역된 홈페이지¶

Wagtail에서 사이트를 설정할 때 ‘루트 페이지’ 필드에서 사이트의 홈페이지를 선택하면 해당 사이트의 루트 URL에 대한 모든 요청이 해당 페이지로 라우팅됩니다.

다국어 사이트에는 페이지 트리에서 형제로 존재하는 각 로케일에 대한 별도의 홈페이지가 있습니다. Wagtail은 사이트의 ‘루트 페이지’ 번역을 찾아 다른 홈페이지를 찾습니다.

이는 사이트를 다른 로케일에서 사용할 수 있도록 하려면 해당 새 로케일에서 홈페이지를 번역하고 게시하기만 하면 된다는 의미입니다.

Wagtail이 사용자 언어와 일치하는 홈페이지를 찾을 수 없는 경우 사이트 레코드에서 ‘루트 페이지’로 선택된 페이지로 대체되므로 이 필드를 사용하여 사이트의 기본 언어를 지정할 수 있습니다.

언어 감지 및 라우팅¶

사용자 언어를 감지하고 URL에 접두사(/en/, /fr-fr/ 등)를 추가하기 위해 Wagtail은 Django의 내장 국제화 유틸리티(예: i18n_patterns 및 LocaleMiddleware)와 함께 작동하도록 설계되었습니다. 이는 Wagtail이 사이트의 다른 국제화된 Django 애플리케이션과 원활하게 작동해야 함을 의미합니다.

로케일¶

사이트에서 활성화된 로케일은 wagtailcore 의 Locale 모델에 기록됩니다. 이 모델에는 ID와 language_code 라는 두 개의 필드만 있으며, 이 필드는 이 로케일을 나타내는 BCP-47 언어 태그를 저장합니다.

로케일 레코드는 선택적 관리 UI로 설정하거나 셸에서 생성할 수 있습니다. 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- 로케일은 “프랑스어” 언어 트리를 사용합니다. 언어의 각 로케일 간의 차이는 프로그래밍 방식일 수 있습니다. 예를 들어, 사용할 날짜/숫자 형식 및 가격을 표시할 통화입니다.

로케일 관리 UI 활성화 (선택 사항)¶

Wagtail 관리자가 Wagtail 관리 인터페이스에서 로케일을 설정할 수 있도록 하는 선택적 로케일 관리 앱이 있습니다.

활성화하려면 wagtail.locales 를 INSTALLED_APPS 에 추가하십시오.

# my_project/settings.py

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

URL에 언어 접두사 추가¶

모든 페이지 트리가 동일한 도메인에서 제공되도록 하려면 각 언어에 대한 URL 접두사를 추가해야 합니다.

이를 구현하기 위해 Django의 내장 i18n_patterns() 함수를 사용할 수 있습니다. 이 함수는 전달된 모든 URL 패턴에 언어 접두사를 추가합니다. 이렇게 하면 URL에 지정된 언어 코드가 활성화되고 Wagtail은 요청을 라우팅하는 방법을 결정할 때 이를 고려합니다.

프로젝트의 urls.py 에 Wagtail의 핵심 URL(및 번역하려는 다른 URL)을 i18n_patterns 블록에 추가하십시오.

# /my_project/urls.py

# ...

from django.conf.urls.i18n import i18n_patterns

# 번역 불가능한 URL
# 참고: Wagtail API 또는 사이트맵을 사용하는 경우,
# 이들도 `i18n_patterns` 에 추가해서는 안 됩니다.
urlpatterns = [
    path('django-admin/', admin.site.urls),

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

# 번역 가능한 URL
# 이들은 언어 코드 접두사 아래에서 사용할 수 있습니다. 예를 들어 /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
# ...

# 이 URL은 LANGUAGE_CODE에서 기본값으로 설정되지 않은 언어에 대해서만 언어 코드 접두사 아래에서 사용할 수 있습니다.

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

- /search/
- /fr/search/

사용자 언어 자동 감지¶

i18n_patterns 로 URL 패턴을 래핑한 후 사이트는 이제 URL 접두사에 응답합니다. 그러나 이제 루트 경로에는 응답하지 않습니다.

이를 해결하려면 사용자의 브라우저 언어를 감지하고 가장 적합한 언어 접두사로 리디렉션해야 합니다. 이를 수행하는 권장 방법은 Django의 LocaleMiddleware 를 사용하는 것입니다.

# my_project/settings.py

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

사용자 정의 라우팅/언어 감지¶

이를 위해 i18n_patterns 또는 LocaleMiddleware 를 반드시 사용해야 하는 것은 아니며 필요한 경우 자체 로직을 작성할 수 있습니다.

Wagtail에 필요한 것은 wagtail.views.serve 뷰가 호출되기 전에 언어가 활성화되는 것입니다(Django의 django.utils.translation.activate 함수 사용).

언어/지역 선택기¶

아마도 사이트에 추가할 수 있는 국제화 관련 UI 중 가장 중요한 부분은 사용자가 다른 언어 간에 전환할 수 있도록 하는 선택기일 것입니다.

이것이 필요하다고 확신하지 못한다면, 몇 가지 근거에 대해 https://www.w3.org/International/questions/qa-site-conneg#stickiness를 살펴보십시오.

{# 이들이 파일 맨 위에 있는지 확인하십시오 #}
{% load wagtailcore_tags %}

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

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

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

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

{% load i18n %}

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

# 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 필터¶

헤드리스 사이트의 경우 Wagtail API는 국제화된 사이트에 대해 두 가지 추가 필터를 지원합니다.

• ?locale= 주어진 로케일로 페이지 필터링

• ?translation_of= 주어진 페이지 ID의 번역만 포함하도록 페이지 필터링

자세한 내용은 국제화된 사이트를 위한 특수 필터를 참조하십시오.

번역 가능한 스니펫¶

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)

    # 모델에 Meta 클래스가 있는 경우,
    # BootstrapTranslatableMixin.Meta도 상속받도록 하십시오.
    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'),
    ]

    # 여기에 부트스트랩할 각 모델에 대한 작업을 하나씩 추가하십시오.
    # 참고: 동일한 앱에 있는 모델만 포함하십시오!
    operations = [
        BootstrapTranslatableModel('myapp.Advert'),
    ]

# myapp/models.py

from wagtail.models import TranslatableMixin  # 이 줄을 변경하십시오.

@register_snippet
class Advert(TranslatableMixin, models.Model):  # 이 줄을 변경하십시오.
    name = models.CharField(max_length=255)

    class Meta(TranslatableMixin.Meta):  # 이 줄을 변경하십시오 (있는 경우).
        verbose_name = 'adverts'

python manage.py makemigrations myapp
python manage.py migrate

Wagtail Localize¶

Wagtail 코어의 국제화를 구현하기 위한 초기 작업의 일환으로 wagtail-localize 라는 번역 패키지도 만들었습니다. 이 패키지는 PO 파일, 기계 번역 및 번역 서비스와의 외부 통합을 사용하여 Wagtail 내에서 페이지를 번역하는 것을 지원합니다.

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