在Django框架中设置语言偏好的教程


Posted in Python onJuly 27, 2015

一旦你准备好了翻译,如果希望在Django中使用,那么只需要激活这些翻译即可。

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

要设定一个安装阶段的语种偏好,请设定LANGUAGE_CODE。如果其他翻译器没有找到一个译文,Django将使用这个语种作为缺省的翻译最终尝试。

如果你只是想要用本地语言来运行Django,并且该语言的语言文件存在,只需要简单地设置 LANGUAGE_CODE 即可。

如果要让每一个使用者各自指定语言偏好,就需要使用 LocaleMiddleware 。 LocaleMiddleware 使得Django基于请求的数据进行语言选择,从而为每一位用户定制内容。 它为每一个用户定制内容。

使用 LocaleMiddleware 需要在 MIDDLEWARE_CLASSES 设置中增加 'django.middleware.locale.LocaleMiddleware' 。 中间件的顺序是有影响的,最好按照依照以下要求:

    保证它是第一批安装的中间件类。

    因为 LocalMiddleware 要用到session数据,所以需要放在 SessionMiddleware 之后。

    如果你使用CacheMiddleware,把LocaleMiddleware放在它后面。

例如, MIDDLE_CLASSES 可能会是如此:

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

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

  •     首先,在当前用户的 session 的中查找django_language键;
  •     如未找到,它会找寻一个cookie
  •     还找不到的话,它会在 HTTP 请求头部里查找Accept-Language, 该头部是你的浏览器发送的,并且按优先顺序告诉服务器你的语言偏好。 Django会尝试头部中的每一个语种直到它发现一个可用的翻译。
  •     以上都失败了的话, 就使用全局的 LANGUAGE_CODE 设定值。

备注:

    在上述每一处,语种偏好应作为字符串,以标准的语种格式出现。 例如,巴西葡萄牙语是pt-br

    如果一个基本语种存在而亚语种没有指定,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文件的例子:

ugettext = lambda s: s

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

    这样做的话, make-messages.py 仍会寻找并标记出将要被翻译的这些字符串,但翻译不会在运行时进行,故而需要在任何使用 LANGUAGES 的代码中用“真实的” ugettext()。

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

    以英语的 .po 文件为基础,翻译其中的技术相关的信息,可能还包括一些使之生效的信息。

    技术相关的信息ID很容易被认出来:它们都是大写的。 这些信息ID的翻译与其他信息不同:你需要提供其对应的本地化内容。 例如,对于 DATETIME_FORMAT (或 DATE_FORMAT 、 TIME_FORMAT ),应该提供希望在该语言中使用的格式化字符串。 格式被模板标签now用来识别格式字符串。

一旦LocaleMiddleware决定用户的偏好,它会让这个偏好作为request.LANGUAGE_CODE对每一个HttpRequest有效。请随意在你的视图代码中读一读这个值。 以下是一个简单的例子:

def hello_world(request):
  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中。
在你自己的项目中使用翻译

Django使用以下算法寻找翻译:

  •     首先,Django在该视图所在的应用程序文件夹中寻找 locale 目录。 若找到所选语言的翻译,则加载该翻译。
  •     第二步,Django在项目目录中寻找 locale 目录。 若找到翻译,则加载该翻译。
  •     最后,Django使用 django/conf/locale 目录中的基本翻译。

以这种方式,你可以创建包含独立翻译的应用程序,可以覆盖项目中的基本翻译。 或者,你可以创建一个包含几个应用程序的大项目,并将所有需要的翻译放在一个大的项目信息文件中。 决定权在你手中。

所有的信息文件库都是以同样方式组织的: 它们是:

$APPPATH/locale/<language>/LC_MESSAGES/django.(po|mo)

  $PROJECTPATH/locale/<language>/LC_MESSAGES/django.(po|mo)

    所有在settings文件中 LOCALE_PATHS 中列出的路径以其列出的顺序搜索 <language>/LC_MESSAGES/django.(po|mo)

$PYTHONPATH/django/conf/locale/<language>/LC_MESSAGES/django.(po|mo)

要创建信息文件,也是使用 django-admin.py makemessages.py 工具,和Django信息文件一样。 需要做的就是进入正确的目录—— conf/locale (在源码树的情况下)或者 locale/ (在应用程序信息或项目信息的情况下)所在的目录下。 同样地,使用 compile-messages.py 生成 gettext 需要使用的二进制 django.mo 文件。

您亦可运行django-admin.py compilemessages --settings=path.to.settings 来使编译器处理所有存在于您 LOCALE_PATHS 设置中的目录。

应用程序信息文件稍微难以发现——因为它们需要 LocaleMiddle 。如果不使用中间件,Django只会处理Django的信息文件和项目的信息文件。

最后,需要考虑一下翻译文件的结构。 若应用程序要发放给其他用户,应用到其它项目中,可能需要使用应用程序相关的翻译。 但是,使用应用程序相关的翻译和项目翻译在使用 make-messages 时会产生古怪的问题。它会遍历当前路径下所有的文件夹,这样可能会把应用消息文件里存在的消息ID重复放入项目消息文件中。

最容易的解决方法就是将不属于项目的应用程序(因此附带着本身的翻译)存储在项目树之外。 这样做的话,项目级的 make-messages 将只会翻译与项目精确相关的,而不包括那些独立发布的应用程序中的字符串。

Python 相关文章推荐
Python操作sqlite3快速、安全插入数据(防注入)的实例
Apr 26 Python
Python中文件遍历的两种方法
Jun 16 Python
Python随机生成彩票号码的方法
Mar 05 Python
Python实现将16进制字符串转化为ascii字符的方法分析
Jul 21 Python
python创建文件备份的脚本
Sep 11 Python
介绍一款python类型检查工具pyright(推荐)
Jul 03 Python
在OpenCV里实现条码区域识别的方法示例
Dec 04 Python
Python 3 使用Pillow生成漂亮的分形树图片
Dec 24 Python
python模式 工厂模式原理及实例详解
Feb 11 Python
Pytest单元测试框架如何实现参数化
Sep 05 Python
Python 操作 MySQL数据库
Sep 18 Python
浅谈pytorch中的dropout的概率p
May 27 Python
在Python的Django框架中创建语言文件
Jul 27 #Python
在Django的模型和公用函数中使用惰性翻译对象
Jul 27 #Python
使用Django的模版来配合字符串翻译工作
Jul 27 #Python
Django中的“惰性翻译”方法的相关使用
Jul 27 #Python
在Python中的Django框架中进行字符串翻译
Jul 27 #Python
Python中特殊函数集锦
Jul 27 #Python
Python实现截屏的函数
Jul 26 #Python
You might like
php 连接mysql连接被重置的解决方法
2011/02/15 PHP
php方法调用模式与函数调用模式简例
2011/09/20 PHP
php使用curl简单抓取远程url的方法
2015/03/13 PHP
分享php邮件管理器源码
2016/01/06 PHP
PHP生成随机数的方法总结
2018/03/01 PHP
在textarea文本域中显示HTML代码的方法
2007/03/06 Javascript
javascript基础第一章 JavaScript与用户端
2010/07/22 Javascript
jquery动画2.元素坐标动画效果(创建一个图片走廊)
2012/08/24 Javascript
JS常用字符串处理方法应用总结
2014/05/22 Javascript
深入浅析JavaScript中数据共享和数据传递
2016/04/25 Javascript
jQuery DataTables插件自定义Ajax分页实例解析
2020/04/28 Javascript
javascript中的try catch异常捕获机制用法分析
2016/12/14 Javascript
使用get方式提交表单在地址栏里面不显示提交信息
2017/02/21 Javascript
JavaScript编程设计模式之构造器模式实例分析
2017/10/25 Javascript
详解PHP后期静态绑定分析与应用
2018/03/21 Javascript
微信小程序解除10个请求并发限制
2018/12/18 Javascript
vue中使用v-model完成组件间的通信
2019/08/22 Javascript
layui 阻止图片上传的实例(before方法)
2019/09/26 Javascript
在vue中利用v-html按分号将文本换行的例子
2019/11/14 Javascript
用yum安装MySQLdb模块的步骤方法
2016/12/15 Python
Python3学习urllib的使用方法示例
2017/11/29 Python
Python爬虫框架Scrapy常用命令总结
2018/07/26 Python
在Python中定义一个常量的方法
2018/11/10 Python
python 表格打印代码实例解析
2019/10/12 Python
python tornado使用流生成图片的例子
2019/11/18 Python
解决echarts中饼图标签重叠的问题
2020/05/16 Python
HTML5高仿微信聊天、微信聊天表情|对话框|编辑器功能
2018/04/23 HTML / CSS
Wiggle中国:英国骑行、跑步、游泳 & 铁三运动装备专卖网店
2016/08/02 全球购物
意大利高端时尚买手店:Stefania Mode
2018/03/01 全球购物
Hotels.com加拿大:领先的在线住宿网站
2018/10/05 全球购物
致800米运动员广播稿
2014/02/16 职场文书
3.12植树节活动总结2014
2014/03/13 职场文书
企业法人代表授权委托书
2014/10/02 职场文书
2019送给家人们的中秋节祝福语
2019/08/15 职场文书
导游词之西递宏村
2019/12/10 职场文书
使用这 6个Vue加载动画库来减少我们网站的跳出率
2021/05/18 Vue.js