如何使用 Django 进行多语言支持？

推荐答案

在 Django 中实现多语言支持可以通过以下步骤完成：

1. 启用国际化（i18n）支持： 在 settings.py 中启用 django.middleware.locale.LocaleMiddleware 中间件，并配置 LANGUAGES 和 LOCALE_PATHS。

   // www.javascriptcn.com code example
   MIDDLEWARE = [
       ...
       'django.middleware.locale.LocaleMiddleware',
       ...
   ]
   
   LANGUAGES = [
       ('en', 'English'),
       ('es', 'Spanish'),
       ('fr', 'French'),
   ]
   
   LOCALE_PATHS = [
       os.path.join(BASE_DIR, 'locale'),
   ]

2. 标记翻译字符串： 在代码中使用 gettext 或 gettext_lazy 函数标记需要翻译的字符串。

   from django.utils.translation import gettext as _
   
   def my_view(request):
       output = _("Welcome to my site.")
       return HttpResponse(output)

3. 生成翻译文件： 使用 django-admin makemessages 命令生成 .po 文件。

   django-admin makemessages -l es

4. 翻译字符串： 在生成的 .po 文件中填写翻译内容。

5. 编译翻译文件： 使用 django-admin compilemessages 命令编译 .po 文件为 .mo 文件。

   django-admin compilemessages

6. 设置语言偏好： 用户可以通过 URL 参数、Cookie 或浏览器设置来切换语言。

   from django.utils.translation import activate
   
   def set_language(request):
       user_language = 'es'
       activate(user_language)
       request.session[translation.LANGUAGE_SESSION_KEY] = user_language
       return HttpResponse("Language set to Spanish.")

本题详细解读

1. 启用国际化支持

Django 的国际化支持是通过中间件 LocaleMiddleware 实现的。该中间件会根据用户的请求自动选择适当的语言。LANGUAGES 设置定义了支持的语言列表，而 LOCALE_PATHS 指定了翻译文件的存储路径。

2. 标记翻译字符串

在 Django 中，所有需要翻译的字符串都应该使用 gettext 或 gettext_lazy 函数进行标记。gettext 用于立即翻译字符串，而 gettext_lazy 用于延迟翻译，通常在模型字段或表单中使用。

3. 生成翻译文件

makemessages 命令会扫描项目中的代码和模板，提取所有标记为需要翻译的字符串，并生成 .po 文件。.po 文件是一个文本文件，包含了原始字符串和对应的翻译字符串。

4. 翻译字符串

在生成的 .po 文件中，开发者需要为每个字符串提供翻译。翻译完成后，保存文件。

5. 编译翻译文件

compilemessages 命令将 .po 文件编译为 .mo 文件，这是 Django 实际使用的二进制格式的翻译文件。

6. 设置语言偏好

用户可以通过多种方式设置语言偏好，包括 URL 参数、Cookie 或浏览器设置。Django 提供了 activate 函数来临时切换语言，也可以通过设置 LANGUAGE_SESSION_KEY 来持久化用户的语言偏好。

通过以上步骤，Django 应用可以实现多语言支持，为用户提供更好的本地化体验。