国际化与本地化：Django框架入门指南

在开发面向全球用户的应用时，国际化（Internationalization, 简称i18n）和本地化（Localization, 简称l10n）是两个至关重要的概念。Django作为一个功能强大的Python Web框架，内置了对国际化与本地化的全面支持，使得开发者能够轻松地为不同语言和地区的用户定制内容。本章将深入探讨Django中的国际化与本地化机制，包括如何准备项目以支持多语言、翻译文本、处理时间格式、数字格式以及时区等。

一、国际化基础

1.1 国际化概述

国际化（i18n）是指设计和开发软件时，使其能够支持多种语言和文化，而无需修改软件代码本身。这通常涉及将软件中的字符串、日期、时间、货币等可能因地区而异的元素提取出来，通过配置文件或数据库进行管理。

1.2 Django中的国际化支持

Django通过一系列工具和约定来支持国际化。首先，你需要确保你的Django项目被设置为支持国际化。这通常涉及以下几个步骤：

• 设置USE_I18N和USE_L10N：在项目的settings.py文件中，确保USE_I18N = True和USE_L10N = True。这两个设置分别启用Django的国际化支持和本地化支持。
• 创建.po文件：Django使用gettext工具集来处理翻译。对于每个需要翻译的语言，你都需要在Django项目的locale目录下创建相应的.po（Portable Object）文件。这些文件包含了原始字符串及其翻译。
• 标记可翻译字符串：在Django模板和Python代码中，使用{% trans %}模板标签和gettext、ugettext、pgettext等函数来标记需要翻译的字符串。

二、翻译文本

2.1 模板中的翻译

在Django模板中，你可以使用{% trans "string_to_translate" %}来标记需要翻译的字符串。例如：

<p>{% trans "Welcome to our website!" %}</p>

对于包含变量的字符串，可以使用{% blocktrans %}标签：

<p>{% blocktrans %}There are {{ count }} new messages.{% endblocktrans %}</p>

2.2 Python代码中的翻译

在Python代码中，你可以使用gettext模块提供的函数来翻译字符串。Django为此提供了一个封装，即django.utils.translation模块中的gettext、ugettext、pgettext等函数。例如：

from django.utils.translation import gettext as _
def my_view(request):
    message = _("Welcome to our website!")
    return HttpResponse(message)

三、处理日期、时间和数字

3.1 日期和时间

Django的本地化支持包括自动根据用户的语言偏好来格式化日期和时间。这通过settings.py中的TIME_ZONE和USE_TZ设置来控制。TIME_ZONE设置项目的默认时区，而USE_TZ决定是否启用时区支持。

在模板中，你可以使用{% localize %}模板标签来确保日期和时间按照当前激活的语言环境进行格式化。例如：

{% load i18n %}
{% localize %}
<p>Today is {{ value|date:"SHORT_DATE_FORMAT" }}.</p>
{% endlocalize %}

3.2 数字

对于数字的格式化，Django同样提供了本地化支持。在模板中，你可以使用{% localize off %}来关闭数字的本地化，但通常情况下，Django会根据当前的语言环境自动格式化数字。

四、时区处理

在Django中处理时区时，重要的是要理解USE_TZ设置的作用。当USE_TZ = True时，Django会在内部使用UTC时间，并在显示给用户时根据用户的时区进行转换。这要求你的数据库也存储UTC时间，并在需要时进行转换。

你可以通过settings.py中的TIME_ZONE设置来指定项目的默认时区，但这通常只用于内部处理，如日志记录等。对于用户，Django会根据用户的会话或请求头中的信息来确定其时区。

五、创建和管理翻译文件

5.1 生成.po文件

Django提供了一个makemessages命令来自动生成.po文件。在项目根目录下运行以下命令：

django-admin makemessages -l zh_hans

这将为简体中文（zh_hans）生成一个.po文件，其中包含所有标记为可翻译的字符串。

5.2 编辑.po文件

生成的.po文件包含了原始字符串和待翻译的字符串。你需要使用文本编辑器或专门的工具（如Poedit）来编辑这些文件，将待翻译的字符串替换为相应的翻译。

5.3 编译.mo文件

完成翻译后，你需要将.po文件编译成.mo（Machine Object）文件，这是Django用来查找翻译的文件格式。使用compilemessages命令来完成这一步：

django-admin compilemessages

六、激活语言和时区

6.1 激活语言

在Django中，你可以通过几种方式来激活特定的语言：

• 在请求中设置：Django会根据请求的Accept-Language头部自动选择语言，但你也可以在视图中显式设置。
• 在模板中设置：使用{% language %}模板标签可以在模板的某个部分临时更改语言。
• 在URL中设置：通过URL参数或路径前缀来指定语言是一种常见的做法，这通常需要在URL配置中做一些额外的设置。

6.2 激活时区

对于时区，Django同样提供了灵活的激活方式：

• 在请求中设置：Django会根据用户的会话或请求头中的信息来设置时区。
• 在代码中设置：你可以使用timezone.activate(timezone.get_timezone('Asia/Shanghai'))来在代码中显式设置时区。

七、最佳实践

• 尽早考虑国际化：在项目的早期阶段就考虑国际化，可以避免后期大量的重构工作。
• 使用Django的国际化工具：充分利用Django提供的国际化工具，如makemessages、compilemessages等，来简化翻译流程。
• 测试：在添加新语言或修改翻译后，务必进行彻底的测试，以确保所有内容都按预期显示。
• 考虑性能：虽然Django的国际化机制非常高效，但在处理大量翻译或复杂本地化需求时，仍需关注性能问题。

通过本章的学习，你应该已经掌握了Django框架中国际化与本地化的基本概念和操作方法。无论是为网站添加多语言支持，还是处理不同地区的日期、时间和数字格式，Django都提供了强大的工具和灵活的机制来帮助你实现这些功能。