django-linguist 0.6.0

模型

三步完成

1. 将 linguist.metaclasses.ModelMeta 添加到您的模型中作为元类

2. 将 linguist.mixins.ManagerMixin 添加到您的模型管理器

3. 在您的模型的 Meta 中添加 linguist 设置

不用担心，这相当简单

from django.db import models
from django.utils.translation import gettext_lazy as _

from linguist.metaclasses import ModelMeta as LinguistMeta
from linguist.mixins import ManagerMixin as LinguistManagerMixin


class PostManager(LinguistManagerMixin, models.Manager):
    pass


class Post(models.Model, meta=LinguistMeta):
    title = models.CharField(max_length=255)
    body = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    objects = PostManager()

    class Meta:
        verbose_name = _('post')
        verbose_name_plural = _('posts')
        linguist = {
            'identifier': 'can-be-anything-you-want',
            'fields': ('title', 'body'),
            'default_language': 'fr',
        }

linguist 元数据需要以下内容

• identifier：您模型的一个唯一标识符（可以是您想要的任何东西）

• fields：要翻译的模型字段列表或元组

并且可选地需要以下内容

• default_language：要使用的默认语言

• default_language_field：包含要使用的默认语言的字段（见下文）

• decider：要使用而不是默认的翻译模型（见下文）

这就完了。您准备好了。

每个实例的默认语言

有时，您需要在实例级别定义默认语言。Linguist 通过 default_language_field 选项支持此功能。在您的模型中添加一个用于存储默认语言的字段，然后简单地将该字段名称提供给 Linguist。

让我们举一个例子

from django.db import models
from django.utils.translation import gettext_lazy as _

from linguist.metaclasses import ModelMeta as LinguistMeta
from linguist.mixins import ManagerMixin as LinguistManagerMixin


class PostManager(LinguistManagerMixin, models.Manager):
    pass


class Post(models.Model, meta=LinguistMeta):
    title = models.CharField(max_length=255)
    body = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    lang = models.CharField(max_length=5, default='en')
    objects = PostManager()

    class Meta:
        verbose_name = _('post')
        verbose_name_plural = _('posts')
        linguist = {
            'identifier': 'can-be-anything-you-want',
            'fields': ('title', 'body'),
            'default_language': 'en',
            'default_language_field': 'lang',
        }

自定义翻译表

默认情况下，Linguist 将翻译存储到 linguist.models.Translation 表中。因此在一个表中。如果您需要为特定模型使用其他表，Linguist 提供了一种覆盖此行为的方法：使用 deciders。

这实际上非常容易实现。

您可以在三步内完成它

• 创建一个继承自 linguist.models.base.Translation 的模型

• 别忘了将其定义为具体模型（在 Meta 中 abstract = False）

• 将此模型提供给 Linguist 元数据的 decider 选项

这个例子将为您带来光明

from django.db import models
from django.utils.translation import gettext_lazy as _

from linguist.metaclasses import ModelMeta as LinguistMeta
from linguist.mixins import ManagerMixin as LinguistManagerMixin
from linguist.models.base import Translation


# Our Post model decider
class PostTranslation(Translation):
    class Meta:
        abstract = False


class PostManager(LinguistManagerMixin, models.Manager):
    pass


class Post(models.Model, meta=LinguistMeta):
    title = models.CharField(max_length=255)
    body = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    objects = PostManager()

    class Meta:
        verbose_name = _('post')
        verbose_name_plural = _('posts')
        linguist = {
            'identifier': 'can-be-anything-you-want',
            'fields': ('title', 'body'),
            'default_language': 'fr',
            'decider': PostTranslation,
        }

django.contrib.admin

简单使用 linguist.admin.TranslatableModelAdmin 类

from django.contrib import admin
from linguist.admin import TranslatableModelAdmin
from .models import Post


class PostAdmin(TranslatableModelAdmin):
    list_display = ('title', 'body', 'created_at')

admin.site.register(Post, PostAdmin)

额外福利！您可以通过管理员类提供的 languages_column 属性在 list_display 中显示实例的语言

from django.contrib import admin
from linguist.admin import TranslatableModelAdmin
from .models import Post


class PostAdmin(TranslatableModelAdmin):
    list_display = ('title', 'body', 'languages_column', 'created_at')

admin.site.register(Post, PostAdmin)