Django国际化与本地化：深入理解翻译系统

Django国际化与本地化：深入理解翻译系统

django django/django: 是一个用于 Python 的高级 Web 框架，可以用于快速开发安全和可维护的 Web 应用程序，提供了多种内置功能和扩展库，支持多种数据库和模板引擎。 项目地址: https://gitcode.com/gh_mirrors/dj/django

概述

Django框架提供了强大的国际化(i18n)和本地化(l10n)支持，使开发者能够轻松创建多语言网站。本文将深入探讨Django的翻译系统，帮助开发者掌握从标记可翻译字符串到最终呈现给用户的全过程。

核心概念

翻译字符串(Translation Strings)

翻译字符串是需要被翻译的文本片段，开发者需要在代码和模板中明确标记这些字符串。Django不会自动识别所有文本，只有被标记的字符串才会被纳入翻译系统。

消息文件(Message Files)

消息文件(.po)是包含原始字符串和翻译的中间文件，供翻译人员使用。Django提供了工具从代码中提取这些字符串到消息文件中。

Python代码中的国际化

基本翻译方法

Django提供了gettext()函数来标记翻译字符串，通常简写为_：

from django.utils.translation import gettext as _

def my_view(request):
    return HttpResponse(_("Welcome to my site"))

翻译字符串的注意事项

1. 变量与计算值：虽然可以对变量和计算值进行翻译，但Django的字符串提取工具makemessages可能无法自动发现这些字符串。

2. 字符串插值：推荐使用命名插值(%(name)s)而非位置插值(%s)，因为不同语言的语序可能不同。

_("Today is %(month)s %(day)s") % {"month": "November", "day": "26"}

3. f-string限制：不能直接对f-string使用翻译函数，因为变量会在翻译前被替换。

翻译注释

为帮助翻译人员理解上下文，可以添加翻译注释：

# Translators: This message appears on the home page only
output = _("Welcome to my site")

标记但不翻译

使用gettext_noop()标记字符串但不立即翻译，适用于需要后期翻译的场景，如数据库中的字符串。

复数处理

不同语言对复数的处理规则不同，使用ngettext()正确处理复数形式：

ngettext(
    "There is %(count)d object",
    "There are %(count)d objects",
    count
) % {"count": count}

上下文标记

当单词有多个含义时，使用pgettext()提供上下文：

pgettext("month name", "May")

延迟翻译(Lazy Translation)

为什么需要延迟翻译

在模块加载时执行的代码路径中（如模型定义），需要使用延迟翻译函数（带有lazy后缀的函数），它们只在值被访问时才进行翻译。

常见使用场景

1. 模型字段的verbose_name和help_text：

class MyThing(models.Model):
    name = models.CharField(help_text=gettext_lazy("This is the help text"))

2. 模型关系字段：

kind = models.ForeignKey(
    ThingKind,
    verbose_name=gettext_lazy("kind")
)

3. 模型元数据：

class Meta:
    verbose_name = gettext_lazy("my thing")
    verbose_name_plural = gettext_lazy("my things")

4. admin装饰器描述：

@admin.display(description=gettext_lazy("Is it a mouse?"))
def is_mouse(self):
    return self.kind.type == MOUSE_TYPE

处理延迟翻译对象

延迟翻译对象可以在Django代码中像普通字符串一样使用，但在与非Django代码交互时需要显式转换为字符串：

str(gettext_lazy("I ❤ Django"))

延迟翻译与复数

当使用延迟翻译处理复数时，可以使用键名代替具体的数字：

error_message = ngettext_lazy(
    "You provided %(num)d argument",
    "You provided %(num)d arguments",
    "num"
)

最佳实践

1. 始终为模型提供显式的verbose_name和verbose_name_plural，而不是依赖Django的自动生成。

2. 在不需要国际化的项目中，设置USE_I18N = False以提高性能。

3. 确保已激活翻译中间件LocaleMiddleware。

4. 使用命名插值而非位置插值，以支持不同语言的语序变化。

5. 为翻译人员提供充分的上下文信息，特别是可能有歧义的词语。

通过掌握这些概念和技术，开发者可以构建出真正国际化的Django应用，为全球用户提供本地化的体验。

django django/django: 是一个用于 Python 的高级 Web 框架，可以用于快速开发安全和可维护的 Web 应用程序，提供了多种内置功能和扩展库，支持多种数据库和模板引擎。 项目地址: https://gitcode.com/gh_mirrors/dj/django