django-vinaigrette 2.0.1

安装

将vinaigrette添加到设置中的INSTALLED_APPS。

然后，告诉vinaigrette你想翻译哪些字段。因为vinaigrette需要注册信号，所以你应该在模型加载完成时注册你的模型翻译，在适当的apps.py文件中（或你保存AppConfig子类的任何地方）

import vinaigrette

class SaladAppConfig(AppConfig):
    def ready(self):
        # Import the model requiring translation
        from .models import Ingredient  # or...
        Ingredient = self.get_model("Ingredient")

        # Register fields to translate
        vinaigrette.register(Ingredient, ['name', 'description'])

这告诉vinaigrette翻译原料对象上的name和description字段。

使用

安装vinaigrette后，manage.py makemessages生成的PO文件将包含注册字段中的字符串。如果某个字符串被翻译，模型值将是翻译成适当语言的字符串

>>> from django.utils.translation import activate
>>> i = Ingredient(name=u'Lettuce')
>>> i.name
u'Lettuce'
>>> activate('fr')
>>> i.name
u'Laitue'

等等

有一些选项可以限制从哪些对象中收集翻译字符串。请参阅vinaigrette.register的文档字符串。

Vinaigrette为manage.py makemessages添加了--keep-obsolete选项，该选项防止gettext停用不再存在于代码或注册数据库字段中的翻译消息。

Vinaigrette是为始终以默认语言编辑、由网站管理员编辑而不是用户编辑的数据库内容而设计的

• 始终在默认语言中编辑

• 由网站管理员编辑，而不是用户

只有模型实例被翻译。通过Django QuerySet values方法访问的数据将不会被翻译。

通常，当访问字段时，如果存在翻译版本，它将始终返回翻译版本。但是，如果设置了值，应将确切输入的值（而不是翻译版本）保存到数据库中。例如

>>> from django.utils.translation import activate
>>> i = Ingredient(name=u'Lettuce')
>>> activate('fr')
>>> i.name
u'Laitue'
>>> i.name = 'Cabbage'
>>> i.name
u'Chou'
>>> i.save()
>>> Ingredient.objects.get(name='Cabbage').name
u'Chou'

贡献

测试

• 为项目创建一个虚拟环境

• 安装tox。当运行tox时，它将为支持的Django和Python版本创建测试环境，然后针对它们运行测试

发布说明