在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 相关文章推荐
50行Python代码实现人脸检测功能
Jan 23 Python
python实现推箱子游戏
Mar 25 Python
python 获取微信好友列表的方法(微信web)
Feb 21 Python
详解Python使用Plotly绘图工具,绘制甘特图
Apr 02 Python
用pyqt5 给按钮设置图标和css样式的方法
Jun 24 Python
django的csrf实现过程详解
Jul 26 Python
利用Python绘制有趣的万圣节南瓜怪效果
Oct 31 Python
pytorch模型存储的2种实现方法
Feb 14 Python
Python中pyecharts安装及安装失败的解决方法
Feb 18 Python
django xadmin 管理器常用显示设置方式
Mar 11 Python
python 实现非极大值抑制算法(Non-maximum suppression, NMS)
Oct 15 Python
python 基于DDT实现数据驱动测试
Feb 18 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
数据库相关问题
2006/10/09 PHP
PHP Curl多线程原理实例详解
2013/11/06 PHP
php使用fgetcsv读取csv文件出现乱码的解决方法
2014/11/08 PHP
JavaScript 全面解析各种浏览器网页中的JS 执行顺序
2009/02/17 Javascript
Mootools 1.2教程 Fx.Morph、Fx选项和Fx事件
2009/09/15 Javascript
用Greasemonkey 脚本收藏网站会员信息到本地
2009/10/26 Javascript
国外大牛IE版本检测!现在IE都到9了,IE检测代码
2012/01/04 Javascript
php中给js数组赋值方法
2014/03/10 Javascript
一个字符串反转函数可实现字符串倒序
2014/09/15 Javascript
nodejs中转换URL字符串与查询字符串详解
2014/11/26 NodeJs
javascript函数式编程实例分析
2015/04/25 Javascript
javascript实现标签切换代码示例
2016/05/22 Javascript
ionic实现带字的toggle滑动组件
2016/08/27 Javascript
JavaScript基础之this详解
2017/06/04 Javascript
详解angular 中的自定义指令之详解API
2017/06/20 Javascript
Vue中的$set的使用实例代码
2018/10/08 Javascript
Vue修改项目启动端口号方法
2019/11/07 Javascript
手把手教你实现 Promise的使用方法
2020/09/02 Javascript
Python爬虫框架Scrapy安装使用步骤
2014/04/01 Python
python实现linux服务器批量修改密码并生成execl
2014/04/22 Python
Python生成验证码实例
2014/08/21 Python
使用python开发vim插件及心得分享
2014/11/04 Python
Python黑魔法@property装饰器的使用技巧解析
2016/06/16 Python
Python解惑之整数比较详解
2017/04/24 Python
Python基于分析Ajax请求实现抓取今日头条街拍图集功能示例
2018/07/19 Python
python 输出所有大小写字母的方法
2019/01/02 Python
在django view中给form传入参数的例子
2019/07/19 Python
Pytorch实现基于CharRNN的文本分类与生成示例
2020/01/08 Python
意大利团购网站:Groupon意大利
2016/10/11 全球购物
香港中原电器网上商店:Chung Yuen
2019/06/26 全球购物
专业技术人员年度考核评语
2014/12/31 职场文书
数学考试作弊检讨书300字
2015/02/16 职场文书
2015年上半年计生工作总结
2015/03/30 职场文书
初婚未育证明样本
2015/06/18 职场文书
Django如何创作一个简单的最小程序
2021/05/12 Python
浅谈什么是SpringBoot异常处理自动配置的原理
2021/06/21 Java/Android