django多语言支持

当我们在构建具有国际化性的web站点时，通常需要满足在不同的国家或地区显示本地的语言。而django提供了强大的翻译机制，并且只需要很少的代码即可完成国际化的需要。django的配置文件settings.py中，默认是开启国际化支持的，USE_I18=True，如果您的站点不需要国际化，那么可以设置USE_I18N=False，这样对于您的站点来说，就不需要加载国际化支持的机制。另外对于django的模板也同样有国际化的支持，如果您不需要，可以将TEMPLATE_CONTEXT_PROCESSORS中的"django.core.context_processors.i18n"去掉。

在python代码中，需要对要翻译的文字进行标记，标记的方法是使用"_"方法。其实是django.utils.translation.gettext方法，类似的方法还有django.utils.translation.gettext，django.utils.translation.gettext_lazy和django.utils.translation.ugettext_lazy方法。通常使用“_”来代替这些名称较长的方法，如“django.utils.translation.ugettext_lazy as _”。以上方法带“u”的表示unicode编码，另外gettext（或ugettext）与gettext_lazy（或ugettext_lazy）有些差异，gettext_lazy使得其值只有在访问时才会被翻译，而不是gettext_lazy调用时翻译。

在编写python代码时，可以这样来标记要翻译的文字，如下model的定义：

[python]  view plain copy

1. from django.utils.translation import ugettext_lazy as _  
2. from django.db import models  
3.   
4. class DemoModel(models.Model):  
5.     demofield = models.CharField(_(u'demo field'), help_text = _(u'Help text'), max_length = 10)  

或者view的定义：

[python]  view plain copy

1. def index(request):  
2.     return HttpResponse(_(u'Welcome to my site.'))  

在定义django的模板时，django也提供了国际化的接口，您需要在模板中添加“{% load i18n %}”，然后就可以使用trans标记了，如：

[xml]  view plain copy

1. {% trans "This is my site" %}  

如果你只想标记字符串而想以后再翻译，可以添加noop选项：

[xml]  view plain copy

1. {% trans "This is my site" noop %}  

但是trans标记只能翻译字符串，不能使用变量，如果有变量需要翻译，那么需要使用{% blocktrans %}标记。使用方法如下：

[xml]  view plain copy

1. {% blocktrans %}This is my site {{ site_name }}{% endblocktrans %}  

另外RequestContext对象有三个针对翻译的变量LANGUAGES,LANGUAGE_CODE和LANGUAGE_BIDI，分别表示语言列表，当前用户语言的偏好，和语言的书写方式：

• LANGUAGES 是一系列元组组成的列表，每个元组的第一个元素是语言代码，第二个元素是用该语言表示的语言名称。
• LANGUAGE_CODE是以字符串表示的当前用户偏好语言（例如， en-us ）。（详见 Django 如何确定语言偏好。）
• LANGUAGE_BIDI是当前语言的书写方式。若设为 True，则该语言书写方向为从右到左（如希伯来语和阿拉伯语）；若设为 False，则该语言书写方向为从左到右（如英语、法语和德语）。

当然如果想要在模板中使用这三个变量就需要在view中添加该对象。如view的返回值：

[python]  view plain copy

1. return render_to_response('app/index', RequestContext(request, {'site_name':'My site name'}))  

其实还有另一种方式，也能达到在模板中使用上面三个变量的目的，如下代码：

[xml]  view plain copy

1. {% load i18n %}  
2. {% get_current_language as LANGUAGE_CODE %}  
3. {% get_available_languages as LANGUAGES %}  
4. {% get_current_language_bidi as LANGUAGE_BIDI %}  

上面介绍了如何进行翻译及其国际化相关的内容，但django默认情况下时根据客户端语言的使用偏好来对内容进行翻译的，但是当我们安装的是英文操作系统希望现在中文界面时，或者中文操作系统显示英文界面时，就需要手动的设置了。实现手动设置语言偏好需要我们在web界面中添加一个语言选择的下拉框。如下，采用自定义tag的方式定义该下拉框，在templatetags目录下添加langs.py文件，内容如下：

[python]  view plain copy

1. # -*- coding:utf-8 -*-  
2. from django import template  
3. from django.utils.translation import get_language_info  
4. from django.conf import settings  
5.   
6. LANGUAGES = []  
7. for lang_code in settings.LANGUAGES_SUPPORTED:  
8.     LANGUAGES.append(get_language_info(lang_code))  
9.       
10. register = template.Library()  
11.  
12. @register.inclusion_tag('app/parts/languages_select_part.html')  
13. def language_select(default):  
14.     return {'languages':LANGUAGES, 'default':default}  

方法language_select接收一个参数，该参数表示当前使用的语言代码，我们将支持的语言配置在settings.LANGUAGES_SUPPORTED下，我们只支持英文和中文。值为:

[python]  view plain copy

1. LANGUAGES_SUPPORTED = ('en', 'zh-cn',)  

“app/parts/languages_select_part.html”模板的定义如下：

[xml]  view plain copy

1. {% if languages %}  
2. <form id="language-select-form" method="post" action="{% url django.views.i18n.set_language %}">{% csrf_token %}  
3. <select class="dropdown" onchange="this.form.submit();" name="language">  
4. {% for lang in languages %}<option value="{{ lang.code }}" {% if lang.code == default %}selected="selected"{% endif %}>{{ lang.name_local }}</option>  
5. {% endfor %}</select>  
6. </form>{% endif %}  

模板中action的值，设置为“{% url django.views.i18n.set_language %}”，这是django提高的设置语言的接口。我们需要在urls.py中添加一段代码：

[python]  view plain copy

1. urlpatterns += patterns('',  
2.     url(r'^setlang/$', 'django.views.i18n.set_language', name = 'setlang'),  
3. )  

那么在网站的模板中，就可以通过如下代码将该下拉框添加到页面中：

[xml]  view plain copy

1. {% load langs %}  
2. {% language_select LANGUAGE_CODE %}  

当选择语言后，页面会自动刷新，并且根据选择的语言进行翻译。如果您的站点还没有翻译，可以查看admin的界面显示。