Django国际化(i18n) – 切换语言

在本文中，我们将介绍Django的国际化(i18n)功能，以及如何通过切换语言来实现多语言网站。

阅读更多：Django 教程

什么是Django的国际化(i18n)功能？

Django的国际化(i18n)功能允许我们在网站中支持多种语言，以便满足不同语言用户的需求。它通过将文本翻译为不同语言的本地化字符串，来实现多语言的支持。

Django的国际化功能基于gettext库，该库使用.po文件来实现翻译功能。我们需要为每种语言创建一个.po文件，并在其中将原始语言短语与其翻译对应起来。Django将根据用户的语言偏好设置来选择正确的翻译字符串。

如何启用Django的国际化功能？

要启用Django的国际化功能，我们需要进行以下步骤：

步骤1：修改settings.py文件

首先，我们需要打开项目中的settings.py文件，并对以下配置进行更改：

LANGUAGE_CODE = 'zh-hans'  # 设置默认语言

# 国际化设置
# 设置翻译文件存放的目录
LOCALE_PATHS = [os.path.join(BASE_DIR, 'locale')] 

# 支持的语言列表
LANGUAGES = (
    ('zh-hans', 'Simplified Chinese'),
    ('en', 'English'),
)

在上述代码中，我们将默认语言设置为中文（简体），并指定了支持的语言列表。我们还设置了翻译文件存放的目录为locale目录。

步骤2：生成翻译文件

接下来，我们需要生成翻译文件。在终端中运行以下命令：

django-admin makemessages -l zh_hans

上述命令将根据我们在settings.py中设置的默认语言生成一个.po文件，用于存放翻译字符串。我们可以根据需要生成其他语言的翻译文件，只需替换-l选项后面的语言代码即可。

步骤3：编辑翻译文件

生成翻译文件后，我们可以打开对应的.po文件，并在其中将原始语言短语与其翻译对应起来。例如，对于以下短语：

gettext("Hello, world!")

我们可以在.po文件中将其翻译为：

msgid "Hello, world!"
msgstr "你好，世界！"

我们可以添加尽可能多的翻译字符串来覆盖网站中使用的所有文本。

步骤4：编译翻译文件

完成所有的翻译后，我们需要将.po文件编译为二进制的.mo文件，以便Django能够读取其内容。在终端中运行以下命令：

django-admin compilemessages

这将在locale目录中生成对应的.mo文件。

如何在网页中切换语言？

现在，我们已经启用了Django的国际化功能，并准备好了翻译文件。接下来，我们将介绍如何在网页中切换语言。

步骤1：添加语言切换链接

为了让用户能够切换语言，我们需要在网页中添加语言切换链接。我们可以创建一个视图函数来处理语言切换，并在模板中使用该函数来生成相应的链接。

首先，我们可以在views.py文件中创建一个视图函数：

from django.utils.translation import activate, get_language

def change_language(request, language_code):
    activate(language_code)
    return redirect(request.META.get('HTTP_REFERER'))

上述视图函数使用activate函数来切换用户的语言偏好设置，并使用redirect函数将用户重定向到之前的页面。

接下来，我们可以在模板中生成语言切换链接：

{% load i18n %}

<ul>
    <li><a href="{% url 'change_language' 'zh-hans' %}">{% trans "中文" %}</a></li>
    <li><a href="{% url 'change_language' 'en' %}">{% trans "English" %}</a></li>
</ul>

上述代码使用Django的国际化模板标签{% trans %}来翻译文本，并生成相应的链接。

步骤2：添加URL配置

在urls.py文件中，我们需要为语言切换链接添加相应的URL配置：

from django.urls import path
from .views import change_language

urlpatterns = [
    # ...
    path('change-language/<str:language_code>/', change_language, name='change_language'),
    # ...
]

上述代码将change_language视图函数与/change-language/路径关联起来，并将语言代码作为参数传递给该视图函数。