django-parler-encore 1.0.0

安装django-parler

可以使用以下方式安装软件包

pip install django-parler

添加以下设置

INSTALLED_APPS += (
    'parler',
)

可选地，也可以配置管理标签页

PARLER_LANGUAGES = {
    None: (
        {'code': 'en',},
        {'code': 'en-us',},
        {'code': 'it',},
        {'code': 'nl',},
    ),
    'default': {
        'fallback': 'en',             # defaults to PARLER_DEFAULT_LANGUAGE_CODE
        'hide_untranslated': False,   # the default; let .active_translations() return fallbacks too.
    }
}

在运行使用站点框架的多站点项目时，将None替换为SITE_ID。每个SITE_ID都可以作为字典中的额外条目添加。

请确保您的项目已配置为支持多语言。限制LANGUAGES设置可能很有用。例如

from django.utils.translation import ugettext_lazy as _

LANGUAGE_CODE = 'en'

LANGUAGES = (
    ('en', _("English")),
    ('en-us', _("US English")),
    ('it', _('Italian')),
    ('nl', _('Dutch')),
    ('fr', _('French')),
    ('es', _('Spanish')),
)

默认情况下，后备语言与LANGUAGE_CODE相同。可以在设置中更改后备语言

PARLER_DEFAULT_LANGUAGE_CODE = 'en'

创建模型

使用TranslatedFields包装器，可以将模型字段标记为可翻译

from django.db import models
from parler.models import TranslatableModel, TranslatedFields

class MyModel(TranslatableModel):
    translations = TranslatedFields(
        title = models.CharField(_("Title"), max_length=200)
    )

    def __unicode__(self):
        return self.title

访问字段

可翻译字段可以像常规字段一样使用

>>> object = MyModel.objects.all()[0]
>>> object.get_current_language()
'en'
>>> object.title
u'cheese omelet'

>>> object.set_current_language('fr')       # Only switches
>>> object.title = "omelette du fromage"    # Translation is created on demand.
>>> object.save()

内部，django-parler将可翻译字段存储在单独的模型中，每个语言一行。

过滤翻译

要查询可翻译字段，请使用.translated()方法

MyObject.objects.translated(title='cheese omelet')

要访问当前和可能的后备语言中的对象，请使用

MyObject.objects.active_translations(title='cheese omelet')

这返回被认为“活跃”的语言中的对象，这些是

• 当前语言

• 当hide_untranslated=False时，在PARLER_LANGUAGES设置中的后备语言。

更改语言

可以指示查询集返回特定语言的对象

>>> objects = MyModel.objects.language('fr').all()
>>> objects[0].title
u'omelette du fromage'

这仅设置对象的语言。默认情况下，使用当前的Django语言。

使用object.get_current_language()和object.set_current_language()在单个对象上更改语言。还有一个上下文管理器来执行此操作

from parler.utils.context import switch_language

with switch_language(model, 'fr'):
    print model.title

还有一个函数用于查询特定字段

model.safe_translation_getter('title', language_code='fr')

高级功能

此包还包括

• 手动创建TranslatedFieldsModel！

• 用于内联支持的表单类。

• 用于切换语言、创建/更新可翻译对象的视图类。

• 用于语言切换按钮的模板标签。

• 用于处理可翻译字段的ORM方法。

• 支持内联的管理。

有关更多详细信息，请参阅文档。