标准的翻译函数

ocf07R <a href=”http://qpopfudogomm.com/“>qpopfudogomm</a>, [url=http://zlxzyubhhfhd.com/]zlxzyubhhfhd[/url], [link=http://dbedjhghgiph.com/]dbedjhghgiph[/link], http://opgcbbdwditr.com/

在下�这个例�中，这段文本 "Welcome to my site" 被标记为翻译字符串：

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

函数 django.utils.translation.gettext() 与 _() 是相�的。下�这个例�与�一个例�没有区别：

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

大多数开�者喜欢使用 _() , 因为它比较短�.

翻译字符串对于语��样有效。下�这个例�和��两个例�相�：

def my_view(request):
    words = ['Welcome', 'to', 'my', 'site.']
    output = _(' '.join(words))
    return HttpResponse(output)

翻译也�以对��进行。�样的例�：

def my_view(request):
    sentence = 'Welcome to my site.'
    output = _(sentence)
    return HttpResponse(output)

（如以上两个例�所示地使用��或语�，需�注�的一点是Django的翻译字符串检测工具， make-messages.py ，�能找到这些字符串。在��的内容中会继续讨论这个问题。）

传递给 _() 或 gettext() 的字符串�以接�由Python标准字典型对象的格�化字符串表达�指定的��符，比如：

def my_view(request, n):
    output = _('%(name)s is my name.') % {'name': n}
    return HttpResponse(output)

这项技术使得特定语言的译文�以对这段文本进行�新排�。比如，一段文本的英语翻译为 "Adrian is my name." ，而西�牙语翻译为 "Me llamo Adrian." ，此时，��符（�name）实在被翻译的文本之�而�是之�。

正因为如此，您应该使用字典型对象的格�化字符串（比如， %(name)s ），而�是针对�置的格�化字符串（比如， %s 或 %d ）。如果您使用针对�置的格�化字符串，翻译机制将无法�新安排包���符的文本。

标记字符串为��作

aqx6dN <a href=”http://ngytacoffksa.com/“>ngytacoffksa</a>, [url=http://frgtlggamlkr.com/]frgtlggamlkr[/url], [link=http://rzddwvkeesje.com/]rzddwvkeesje[/link], http://tsmbjzujsbqn.com/

使用这�方法的环境是，有字符串必须以原始语言的形�存储（如储存在数�库中的字符串）而在最�需�被翻译出�，如当其在用户�显示出�时。

惰性翻译

使用 django.utils.translation.gettext_lazy() 函数，使得其中的值�有在访问时�会被翻译，而�是在 gettext_lazy() 被调用时翻译。

比如，�标记 help_text 列是需�翻译的，�以这么�：

from django.utils.translation import gettext_lazy

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

在这个例�中， gettext_lazy() 将字符串作为惰性翻译字符串存储，此时并没有进行翻译。翻译工作将在字符串在字符串上下文中被用到时进行，比如在Django管�页��交模�时。

如果觉得 gettext_lazy 太过冗长，�以用 _ （下划线）作为别�，就�这样：

from django.utils.translation import gettext_lazy as _

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

在Django模型中最好一直使用惰性翻译（除�这样翻译的结果无法正确地显示）。�时，对于列�和表�最好也能进行翻译。这需�在 Meta 中明确 verbose_name 和 verbose_name_plural 的值：

from django.utils.translation import gettext_lazy as _

class MyThing(models.Model):
    name = models.CharField(_('name'), help_text=_('This is the help text'))
    class Meta:
        verbose_name = _('my thing')
        verbose_name_plural = _('mythings')

�数的处�

使用 django.utils.translation.ngettext() 函数�指定有�数和�数形�之分的信�，比如：

from django.utils.translation import ngettext
def hello_world(request, count):
    page = ngettext(
        'there is %(count)d object',
        'there are %(count)d objects', count
    ) % {'count': count}
    return HttpResponse(page)

ngettext 函数包括三个�数：�数形�的翻译字符串，�数形�的翻译字符串，和对象的个数（将以 count ��传递给需�翻译的语言）。

7jEPL5 <a href=”http://siswbqyeiacu.com/“>siswbqyeiacu</a>, [url=http://wggfxnxdjnmc.com/]wggfxnxdjnmc[/url], [link=http://smzrnicwasqa.com/]smzrnicwasqa[/link], http://xqxscmgtbhpc.com/

Django模�使用两�模�标签，且语法格�与Python代�有些许��。为了使得模�访问到标签，需�将 {% load i18n %} 放在模�最��。

{% trans %} 模�标签标记需�翻译的字符串：

<title>{% trans "This is the title." %}</title>

如果�需�标记字符串而以��翻译，�以使用 noop 选项：

<title>{% trans "value" noop %}</title>

在 {% trans %} 中��许使用模�中的��，�能使用�引�或�引�中的字符串。如果翻译时需�用到��（��符），�以使用 {% blocktrans %} ，比如：

{% blocktrans %}This will have {{ value }} inside.{% endblocktrans %}

使用模�过滤器�翻译一个模�表达�，需�在翻译的这段文本中将表达�绑定到一个本地��中：

{% blocktrans with value|filter as myvar %}
  This will have {{ myvar }} inside.
{% endblocktrans %}

qTgtvg <a href=”http://cbniwxkldxuc.com/“>cbniwxkldxuc</a>, [url=http://lelxwibpyhqi.com/]lelxwibpyhqi[/url], [link=http://climlfoemmpl.com/]climlfoemmpl[/link], http://mmxmuaxedeha.com/

{% blocktrans with book|title as book_t and author|title as author_t %}
  This is {{ book_t }} by {{ author_t }}
{% endblocktrans %}

为了表示��数相关的内容，需�在 {% blocktrans %} 和 {% endblocktrans %} 之间使用 {% plural %} 标签�指定��数形�，例如：

{% blocktrans count list|length as counter %}
  There is only one {{ name }} object.
{% plural %}
  There are {{ counter }} {{ name }} objects.
{% endblocktrans %}

其内在机制是，所有的�和内嵌翻译调用相应的 gettext 或 ngettext 。

使用 RequestContext （�第10章）时，模��以访问三个针对翻译的��：

• {{ LANGUAGES }} 是一系列元组组æˆ�的列表，æ¯�个元组的第一个元素是语言代ç �，第二个元素是用该语言表示的语言å��称。

• {{ LANGUAGE_CODE }} 是以字符串表示的当å‰�用户å��好语言（例如， en-us ）。（详è§� Django 如何确定语言å��好。）

• {{ LANGUAGE_BIDI }} 是当å‰�语言的书写方å¼�。若设为 True ，则该语言书写方å�‘为从å�³åˆ°å·¦ï¼ˆå¦‚希伯æ�¥è¯­å’Œé˜¿æ‹‰ä¼¯è¯­ï¼‰ï¼›è‹¥è®¾ä¸º False ，则该语言书写方å�‘为从左到å�³ï¼ˆå¦‚英语ã€�法语和德语）。

你也�以通过使用模�标签�加载这些��：

{% load i18n %}
{% get_current_language as LANGUAGE_CODE %}
{% get_available_languages as LANGUAGES %}
{% get_current_language_bidi as LANGUAGE_BIDI %}

翻译的hook在任何接�常�字符串的模��标签内也是�以使用的。此时，使用 _() 表达��指定翻译字符串，例如：

{% some_special_tag _("Page not found") value|yesno:_("yes,no") %}

OQy5ZT <a href=”http://zicjwleradwz.com/“>zicjwleradwz</a>, [url=http://klbbjyqcrtdt.com/]klbbjyqcrtdt[/url], [link=http://adylkqwpfagm.com/]adylkqwpfagm[/link], http://bghiparjlrvr.com/

创建语言文件

当你标记了翻译字符串，你就需�写出（或获�已有的）对应的语言翻译信�。在这一节中我们将解释如何使它起作用。

创建信�文件

第一步，就是为一�语言创建一个信�文件。一个信�文件是包�了�一语言翻译字符串和对这些字符串的翻译的一个文本文件。信�文件以 .po 为�缀�。

Django中带有一个工具， bin/make-messages.py ，它完�了这些文件的创建和维护工作。

�行以下命令�创建或更新一个信�文件：

bin/make-messages.py -l de

其中 de 是所创建的信�文件的语言代�。在这里，语言代�是以本地格�给出的。例如，巴西地区的葡�牙语为 pt_BR ，澳大利亚地区的德语为 de_AT 。�查看 django/conf/locale 目录获�Django所支�的语言代�。

这段脚本应该在三处之一�行：

• django 根目录（ä¸�是Subversion检出目录，而是通过 $PYTHONPATH 链接或ä½�于该路径的æŸ�处）

• Django项目根目录

• Django应用程åº�根目录

该脚本作用于所在的整个目录树，并且抽�所有被标记的字符串以进行翻译。它在 conf/locale 目录下创建（或更新）了一个信�文件。在上�这个例�中，这个信�文件是 conf/locale/de/LC_MESSAGES/django.po 。

�行于项目��树或应用程���树下时，该脚本完��样的功能，但是此时locale目录的�置为 locale/LANG/LC_MESSAGES （注�没有``conf``�缀）。在第一次�行时需�创建 locale 目录。

没有gettext?

如果没有安装 gettext 组件， make-messages.py 将会创建空白文件。这�情况下，安装 gettext 组件或�是�制英语信�文件( conf/locale/en/LC_MESSAGES/django.po )�作为一个起点；�是一个空白的翻译信�文件而已。

.po 文件格�很直观。�个 .po 文件包�一�部分的元数�，比如翻译维护人员的�系信�，而文件的大部分内容是简�的翻译字符串和对应语言翻译结果的映射关系的列表。

举个例�，如果Django应用程�包括一个 "Welcome to my site." 的翻译字符串，�这样：

_("Welcome to my site.")

make-message.py 将创建一个包�以下片段的 .po 文件：

#: path/to/python/module.py:23
msgid "Welcome to my site."
msgstr ""

按顺�简�解释一下：

• msgid 是在æº�文件中出现的翻译字符串。ä¸�è¦�å�šæ”¹åŠ¨ã€‚

• msgstr 是相应语言的翻译结果。刚创建时它å�ªæ˜¯ç©ºå­—符串，此时就需è¦�ä½ æ�¥å®Œæˆ�它。注æ„�ä¸�è¦�丢掉语å�¥å‰�å�Žçš„引å�·ã€‚

• 方便起è§�，æ¯�一æ�¡ä¿¡æ�¯åŒ…å�«äº†ç¿»è¯‘字符串所在文件的文件å��和行数。

对于比较长的信�也有其处�方法。 msgstr （或 msgid ）�紧跟�的字符串为一个空字符串。然�真正的内容在其下�的几行。这些字符串会被直接连在一起。�时，��忘了字符串末尾的空格，因为它们会�加空格地连到一起。

比如，以下是一个多行翻译（�自�Django�行的西�牙本地化文件）：

msgid ""
"There's been an error. It's been reported to the site administrators via e-"
"mail and should be fixed shortly. Thanks for your patience."
msgstr ""
"Ha ocurrido un error. Se ha informado a los administradores del sitio "
"mediante correo electrnico y debera arreglarse en breve. Gracias por su "
"paciencia."

注��一行结尾的空格。

注�字符集

当你使用喜爱的文本编辑器创建 .po 文件时，首先请编辑字符集行（�索 "CHARSET" ），并将其设为你将使用的字符集。一般说�，UTF-8对�大多数语言有效，�过 gettext 会处�任何你所使用的字符集。

若�对新创建的翻译字符串校验所有的�代�和模�中，并且更新所有语言的信�文件，�以�行以下命令：

make-messages.py -a

编译信�文件

创建信�文件之�，�次对其�了修改，都需�将它�新编译�一�更有效率的形�，供 gettext 使用。使用 `` bin/compile-messages.py `` �完�这项工作。

这个工具作用于所有有效的 .po 文件，创建优化过的二进制 .mo 文件供 gettext 使用。在�行 make-messages.py 的�一目录下，�行 compile-messages.py ：

bin/compile-messages.py

就是这样了。你的翻译�果已��以使用了。

Django如何处�语言�好

一旦你准备好了翻译，如果希望在Django中使用，那么�需�激活这些翻译��。

在这些功能背�，Django拥有一个�活的模型�确定在安装和使用应用程�的过程中选择使用的语言。

若�在整个安装和使用过程中确定语言�好，就�在设置文件中设置 LANGUAGE_CODE 。Django将用指定的语言�进行翻译，如果没有其它的翻译器�现�进行翻译的语�，这就是最�一步了。

如果你�是想�用本地语言��行Django，并且该语言的语言文件存在，�需�简�地设置 LANGUAGE_CODE ��。

如果�让�一个使用者�自指定语言�好，就需�使用 LocaleMiddleware 。 LocaleMiddleware 使得Django基于请求的数�进行语言选择，从而为�一�用户定制内容。

使用 LocaleMiddleware 需�在 MIDDLEWARE_CLASSES 设置中增加 'django.middleware.locale.LocaleMiddleware' 。中间件的顺�是有影�的，最好按照�照以下�求：

• ä¿�è¯�它是第一批安装的中间件类。

• 因为 LocalMiddleware è¦�用到sessionæ•°æ�®ï¼Œæ‰€ä»¥éœ€è¦�放在 SessionMiddleware 之å�Žã€‚

• 如果使用了 CacheMiddleware ，将 LocaleMiddleware 放在 CacheMiddleware 之å�Žï¼ˆå�¦åˆ™ç”¨æˆ·å�¯èƒ½ä¼šä»Žé”™è¯¯çš„本地化文件中å�–得缓冲数æ�®ï¼‰ã€‚

例如， MIDDLE_CLASSES �能会是如此：

MIDDLEWARE_CLASSES = (
   'django.middleware.common.CommonMiddleware',
   'django.contrib.sessions.middleware.SessionMiddleware',
   'django.middleware.locale.LocaleMiddleware'
)

LocaleMiddleware 按照如下算法确定用户的语言:

• 首先，在当å‰�用户 session 的中查找键 django_language 的值；

• 如果失败的è¯�，接ç�€æŸ¥æ‰¾å��为 django_language çš„ cookie ï¼›

• 还是失败的è¯�，就在 HTTP 请求头部查找 Accept-Language 关键字的值，该关键字是你的æµ�览器å�‘é€�的，按优先顺åº�告诉æœ�务器你的语言å��好。Django 会根æ�®è¿™äº›è¯­è¨€çš„顺åº�é€�一æ�œç´¢ç›´åˆ°å�‘现å�¯ç”¨çš„翻译；

• 以上都失败了的è¯�, 就使用全局的 LANGUAGE_CODE 设定值。

在上述�一处，语言�好应作为字符串，以标准的语言格�出现。比如，巴西地区的葡�牙语表示为 pt-br 。如果Django中�有基本语言而没有其�生的字语言的�，Django将�是用基本语言。比如，如果用户指定了 de-at （澳�德语）但Django�有针对 de 的翻译，那么 de 会被选用。

�有在 LANGUAGES 设置中列出的语言�能被选用。若希望将语言�制为所�供语言中的�些（因为应用程�并��供所有语言的表示），则将 LANGUAGES 设置为所希望�供语言的列表，例如：

LANGUAGES = (
    ('de', _('German')),
    ('en', _('English')),
)

上�这个例��制了语言�好�能是德语和英语（包括它们的�语言，如 de-ch 和 en-us ）。

如果自定义了 LANGUAGES ，将语言标记为翻译字符串是�以的，但是，请��使用 django.utils.translation 中的 gettext() （决��在settings文件中导入 django.utils.translation ，因为这个模�本身是�赖于settings，这样�会导致无�循环），而是使用一个“虚构的� gettext() 。

解决方案就是使用一个“虚�的� gettext() 。以下是一个settings文件的例�：

_ = lambda s: s

LANGUAGES = (
      ('de', _('German')),
      ('en', _('English')),
)

这样�的�， make-messages.py �会寻找并标记出将�被翻译的这些字符串，但翻译�会��行时进行，故而需�在任何使用 LANGUAGES 的代�中用“真实的� gettext() �修饰这些语言。

LocaleMiddleware �能选择那些Django已��供了基础翻译的语言。如果想�在应用程�中对Django中还没有基础翻译的语言�供翻译，那么必须至少先�供该语言的基本的翻译。例如，Django使用特定的信�ID�翻译日期和时间格�，故�让系统正常工作，至少��供这些基本的翻译。

以英语的 .po 文件为基础，翻译其中的技术相关的信�，�能还包括一些使之生效的信�。这会是一个好的开始。

技术相关的信�ID很容易被人出�：它们都是大写的。这些信�ID的翻译与其他信���:你需��供其对应的本地化内容。例如，对于 DATETIME_FORMAT （或 DATE_FORMAT � TIME_FORMAT ），应该�供希望在该语言中使用的格�化字符串。格�和 now 模�标签中使用的格�化字符串一样。

一旦 LocalMiddleware 确定了用户的使用�好，就将其以 request.LANGUAGE_CODE 的形��供给�个请求对象。如此，在视图代�中就�以自由使用了。以下是一个简�的例�：

def hello_world(request, count):
    if request.LANGUAGE_CODE == 'de-at':
        return HttpResponse("You prefer to read Austrian German.")
    else:
        return HttpResponse("You prefer to read another language.")

注�，��翻译（���过中间件）中的语言设置是在 settings.LANGUAGE_CODE 中的，而动�翻译（�使用了中间件）的语言设置实在 request.LANGUAGE_CODE 。

javascript_catalog视图

这些问题的主�解决方案就是 javascript_catalog 视图。该视图生�一个JavaScript代�库，包括模仿 gettext 接�的函数，和翻译字符串的数组。这些翻译字符串�自应用程�，项目，或者Django核心，具体由 info_dict 或URL�确定。

�这样使用：

js_info_dict = {
    'packages': ('your.app.package',),
}

urlpatterns = patterns('',
    (r'^jsi18n/$', 'django.views.i18n.javascript_catalog', js_info_dict),
)

packages 里的�个字符串应该是Python中的点分割的包的表达�形�（和在 INSTALLED_APPS 中的字符串相�的格�），而且应指�包� locale 目录的包。如果指定了多个包，所有的目录会�并�一个目录。如果有用到�自��应用程�的字符串的JavaScript，这�机制会很有帮助。

你�以动�使用视图，将包放在urlpatterns里：

urlpatterns = patterns('',
    (r'^jsi18n/(?P<packages>\S+?)/$, 'django.views.i18n.javascript_catalog'),
)

这样的�，就�以在URL中指定由加�（ + ）分隔包�的包了。如果页�使用�自��应用程�的代�，且�常改�，还�想将其放在一个大的目录文件中，对于这些情况，显然这是很有用的。出于安全考虑，这些值�能是 django.conf 或 INSTALLED_APPS 设置中的包。

使用JavaScript翻译目录

�使用这个目录，��这样引入动�生�的脚本：

<script type="text/javascript" src="/path/to/jsi18n/"></script>

这就是管�页�如何从�务器获�翻译目录。当目录加载�，JavaScript代�就能通过标准的 gettext 接�进行访问：

document.write(gettext('this is to be translated'));

甚至有一个 ngettext 接�和一个字符串查补函数：

d = {
    count: 10
};
s = interpolate(ngettext('this is %(count)s object', 'this are %(count)s objects', d.count), d);

interpolate 函数支��置�补和�字查补。因此��的代�也�以写�这样：

s = interpolate(ngettext('this is %s object', 'this are %s objects', 11), [11]);

�补的语法是借鉴了Python。但�应该超过字符串�补的能力，这�然还是JavaScript，因此代�将�得����的正则替�。它�会和Python中的字符串�补一样快，因此�有真正需�的时候�使用它（例如，利用 ngettext 生��适的�数形�）。

创建JavaScript翻译目录

用和其它Django翻译目录相�的方法�创建和更新JavaScript翻译目录：用 `make-messages.py` 工具。唯一的差别是需��供一个 -d djangojs 的�数，就�这样：

make-messages.py -d djangojs -l de

这样�创建或更新JavaScript的德语翻译目录。和普通的Django翻译目录一样，更新了翻译目录�，�行 compile-messages.py ��。