wagtailtranslations 2.0.1

安装

使用pip安装

$ pip install wagtailtranslations

将其添加到您的INSTALLED_APPS

INSTALLED_APPS = [
    # ...
    'wagtailtranslations',
    # ...
]

它适用于Wagtail 2.2及以上版本。在2.0版本之前请检查版本以确认与旧版本Wagtail的兼容性。

快速入门

定义一个TranslationIndex模型

from wagtailtranslations.models import AbstractTranslationIndexPage

class TranslationHomePage(AbstractTranslationIndexPage):
    subpage_types = ['ContentPage']

将其用作您的网站根页面。您网站支持的每种语言都应该作为单独的页面树位于此索引页面之下。英文主页应使用slug“en”，URL为/en/；而法文主页应使用slug“fr”，URL为/fr/。

定义翻译模型

from wagtail.admin.edit_handlers import FieldPanel
from wagtail.core.fields import RichTextField
from wagtail.core.models import Page
from wagtailtranslations.models import TranslatedPage

class ContentPage(TranslatedPage, Page):
    body = RichTextField()

    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

在Wagtail管理员→设置→语言中启用一些语言，例如英语和法语。

为英语创建一个新的ContentPage。在“翻译”标签中，选择英语作为语言，并留空“翻译为 ...”字段。

为法语创建另一个新的 内容页面。在“翻译”选项卡中，选择“法语”作为语言，并在“翻译为 ...”字段中选择您刚刚创建的英文页面。

测试

要启动测试服务器，请运行

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -e .
$ export DJANGO_SETTINGS_MODULE=tests.settings
$ django-admin migrate
$ django-admin createsuperuser
$ django-admin runserver

运行自动测试套件

# Do not run this from within a virtual environment
$ pip install --user --upgrade tox pip setuptools
$ tox