Django中translation模块和gettext的关系说明

Django中的translation模块和gettext是紧密相关的，用于实现多语言支持。下面将详细说明它们之间的关系，并提供一些使用例子。

1. translation模块：

translation模块是Django中用于处理多语言的核心模块，它提供了一系列函数和类，用于实现字符串的翻译、本地化日期时间、数字等操作。

a. activate()函数：该函数用于激活当前请求的语言，接受一个参数，即语言的code。一般在view函数中使用。

示例：

      from django.utils.translation import activate

      def my_view(request):
          activate('zh-cn')
          ...
      

b. deactivate()函数：该函数用于关闭当前请求的语言，并恢复为默认语言。一般在view函数的结尾处使用。

示例：

      from django.utils.translation import deactivate

      def my_view(request):
          ...
          deactivate()
      

c. gettext()函数：该函数是translation模块的核心函数，用于获取翻译后的字符串。它接受一个字符串作为参数，并返回翻译后的结果。通常，我们会将这个函数简写为_。

示例：

      from django.utils.translation import gettext as _

      def my_view(request):
          translated_string = _('Hello World')
          ...
      

d. pgettext()函数：该函数用于获取带上下文的翻译字符串，接受两个参数，第一个为上下文字符串，第二个为要翻译的字符串。

示例：

      from django.utils.translation import pgettext

      def my_view(request):
          translated_string = pgettext('greeting', 'Hello World')
          ...
      

e. ngettext()函数：该函数用于获取带复数形式的翻译字符串，接受三个参数，分别是单数形式的字符串、复数形式的字符串和一个整数作为参数。

示例：

      from django.utils.translation import ngettext

      def my_view(request):
          num = 3
          translated_string = ngettext('There is %d message', 'There are %d messages', num) % num
          ...
      

2. gettext：

gettext是GNU国际化与本地化工具包，是一个C库，提供了一系列的API用于支持多语言的文本翻译。Django的translation模块就是基于这个库进行开发的。

a. 制作翻译文件：

通过gettext命令行工具可以提取Django项目中的可翻译字符串，并生成翻译文件。这个工具会在代码中扫描特定的函数调用，比如gettext、pgettext和ngettext，并将这些字符串提取为待翻译的条目。

示例：

      python manage.py makemessages --locale=zh_CN
      

b. 编辑翻译文件：

生成的翻译文件通常是.po格式的文件，使用文本编辑器打开这个文件，可以看到原始字符串和翻译字符串的对应关系，我们需要将每个待翻译的条目翻译成目标语言。

c. 编译翻译文件：

编辑完成后，需要将.po文件编译成二进制的.mo文件，Django能够读取和使用这个文件进行多语言支持。

示例：

      python manage.py compilemessages --locale=zh_CN
      

d. 运行多语言项目：

在Django项目中，可以通过修改settings.py文件来启用多语言支持，并设置默认语言和可用语言列表。

示例：

      LANGUAGE_CODE = 'en-us'

      LANGUAGES = [
          ('en-us', 'English'),
          ('zh-cn', 'Chinese'),
      ]

      USE_I18N = True
      

在模板中使用翻译函数，Django会根据当前请求的语言自动选择对应的翻译字符串。

示例：

      <h1>{% trans "Hello World" %}</h1>
      

总结：

Django中的translation模块是基于gettext库进行开发的，提供了一系列函数和类用于实现多语言支持。通过gettext命令行工具可以将可翻译字符串提取为翻译条目，并生成翻译文件。编辑翻译文件后，可以通过编译生成二进制的.mo文件。在Django项目中，可以通过设置来启用多语言支持，并使用翻译函数进行文本翻译。