djangolanguage_Django国际化和本地化

我理解的国际化和本地化&＃xff0c;是一个Web应用可以使用各种语言和格式提供内容&＃xff0c;为全球各地&＃xff0c;说着不同语言&＃xff0c;写着不同文字的人使用提供便利。软件界面是可以被翻译为各国语言&＃xff0c;可以据某些条件切换。显示的数字&＃xff0c;日期的格式也可以自由选择。国际化英语称为internationalization&＃xff0c;因为太长了&＃xff0c;所以简写为i18n&＃xff0c;因为i和n之间有18个字母。本地化称为localization&＃xff0c;同样可以简写为l10n。还有很关键的一个是时区TimeZone&＃xff0c;决定了显示的时间。

基本配置

项目下settings.py文件&＃xff0c;添加LocaleMiddleware中间件&＃xff1a;

MIDDLEWARE &＃61; [ &＃39;django.middleware.security.SecurityMiddleware&＃39;, &＃39;django.contrib.sessions.middleware.SessionMiddleware&＃39;, &＃39;django.middleware.locale.LocaleMiddleware&＃39;,    &＃39;django.middleware.common.CommonMiddleware&＃39;,     ]

• 它应该位于SessionMiddleware之后,因为 LocaleMiddleware需要依赖session中的数据.它应该在 CommonMiddleware之前&＃xff0c;因为 CommonMiddleware需要语言数据去解析请求URL.

• 如果使用了 CacheMiddleware, 把LocaleMiddleware 放到它后边.

LocaleMiddleware将会使用下边的逻辑确定用户期望使用的语言&＃xff1a;

• 首先, 查看请求URL的前缀&＃xff0c;比如/en/about将会使用英语翻译&＃xff0c;怎样配置URL前缀&＃xff0c;下文有介绍&＃xff0c;详见官方文档。

• 如果失败了(没有发现语言标记),就会去COOKIE中寻找django_language键的信息(这个名称可通过LANGUAGE_COOKIE_NAME 配置)。

• 又失败了, 就会去查看HTTP请求头中的 Accept-Language 项&＃xff0c;django会按优先级逐个查找头信息中期望的语言&＃xff0c;直到找到为止.

• 又失败了, 将会使用全局的LANGUAGE_CODE的配置.

其他一些配置&＃xff1a;

from django.utils.translation import gettext_lazy as _LANGUAGE_CODE &＃61; &＃39;en-us&＃39;TIME_ZONE &＃61; &＃39;UTC&＃39;USE_I18N &＃61; TrueUSE_L10N &＃61; TrueUSE_TZ &＃61; TrueLOCALE_PATHS &＃61; [os.path.join(BASE_DIR, &＃39;mysite/locale&＃39;)]LANGUAGES &＃61; [ (&＃39;en&＃39;, _(&＃39;English&＃39;)), (&＃39;zh-hans&＃39;, _(&＃39;Simplified Chinese&＃39;)),]

其中USE_I18N&＃xff0c;USE_L10N是使能开关。

LOCALE_PATHS很重要&＃xff0c;这个路径存放翻译文件&＃xff0c;而且它的优先级很高&＃xff0c;每个app都有自己的翻译文件&＃xff0c;但是对于安装的第三方app修改源码路径的翻译文件不太好&＃xff0c;可以在这里进行覆盖。

LANGUAGES直接限定了系统存在的翻译语言种类&＃xff0c;这里没有的语言就不会去local路径搜索了&＃xff0c;加速系统的运行&＃xff0c;这里的_(&＃39;English&＃39;)就是自动翻译的标记&＃xff0c;所以最上边的import是为它服务的。

在python代码中使用

其实上边的配置文件也是python代码&＃xff0c;已经用过了&＃xff0c;这里主要指在view中如何使用。

from django.http import HttpResponsefrom django.utils.translation import gettext as _def my_view(request): output &＃61; _("Welcome to my site.") return HttpResponse(output)

最终_("Welcome to my site.")会根据会话决定的语言&＃xff0c;查找对应的翻译文件&＃xff0c;把翻译的内容返回给output变量赋值。更多的技巧见官方文档。关于如何制作翻译文件稍后再说。

在模板文件中使用

模板文件会被模板引擎自动填充扩展成HTML代码&＃xff0c;其中有很多文字是需要翻译的&＃xff0c;这里使用{% trans %}和{% blocktrans %}。

{% trans "This is the title." %}title>{% trans myvar %}title>{% blocktrans %}This string will have {{ value }} inside.{% endblocktrans %}

更多使用方法和细节参看官网手册。

在JS中使用

Javascript的情况更复杂些&＃xff0c;因为它不是在服务端执行的&＃xff0c;要把相关翻译文件和函数传给浏览器&＃xff0c;然后才能使用。

在urlpatterns中注册资源链接地址&＃xff1a;

from django.views.i18n import JavascriptCatalogurlpatterns &＃61; [    path(&＃39;jsi18n/&＃39;, JavascriptCatalog.as_view(),name&＃61;&＃39;Javascript-catalog&＃39;), ]

在模板中引入资源&＃xff1a;

script>

在代码中使用相关函数&＃xff1a;

document.write(gettext(&＃39;this is to be translated&＃39;));

或者将上文的JavascriptCatalog类似的JSONCatalog 引入&＃xff0c;可以获得一条json格式的翻译文件链接&＃xff0c;由其他js库调用。

在URL中使用

在URL中有两个机制&＃xff0c;一个是在url中添加语言的前缀&＃xff0c;一个是使用翻译。

添加前缀很简单&＃xff0c;在注册url时&＃xff0c;使用i18n_patterns包装一下&＃xff1a;

urlpatterns &＃43;&＃61; i18n_patterns( path(&＃39;about/&＃39;, about_views.main, name&＃61;&＃39;about&＃39;), path(&＃39;news/&＃39;, include(news_patterns, namespace&＃61;&＃39;news&＃39;)),)

这样在不同的语言配置下&＃xff0c;最终链接会变成/en/about&＃xff0c;/zh/news格式

第二个是直接在URL中使用翻译&＃xff1a;

from django.utils.translation import gettext_lazy as _urlpatterns &＃43;&＃61; i18n_patterns( path(_(&＃39;about/&＃39;), about_views.main, name&＃61;&＃39;about&＃39;), path(_(&＃39;news/&＃39;), include(news_patterns, namespace&＃61;&＃39;news&＃39;)),)

在模板中使用这种链接可以使用{% language %}标记&＃xff1a; 

{% language lang_code %} {{ lang_name }}a>{% endlanguage %}

如何制作翻译文件