在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中Collection的使用小技巧
Aug 18 Python
Python中的连接符(+、+=)示例详解
Jan 13 Python
Python处理文本换行符实例代码
Feb 03 Python
python字符串查找函数的用法详解
Jul 08 Python
django使用admin站点上传图片的实例
Jul 28 Python
django数据模型(Model)的字段类型解析
Dec 25 Python
Python加密模块的hashlib,hmac模块使用解析
Jan 02 Python
pytorch实现特殊的Module--Sqeuential三种写法
Jan 15 Python
Python decorator拦截器代码实例解析
Apr 04 Python
Python 使用双重循环打印图形菱形操作
Aug 09 Python
Python内存泄漏和内存溢出的解决方案
Sep 26 Python
python实现批量移动文件
Apr 05 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
PHPLog php 程序调试追踪工具
2009/09/09 PHP
PHP实现在线阅读PDF文件的方法
2015/06/17 PHP
php随机显示指定文件夹下图片的方法
2015/07/13 PHP
PHP简单实现记录网站访问量功能示例
2018/06/06 PHP
function, new function, new Function之间的区别
2007/03/08 Javascript
javascript中的有名函数和无名函数
2007/10/17 Javascript
juqery 学习之三 选择器 层级 基本
2010/11/25 Javascript
javascript判断chrome浏览器的方法
2014/03/26 Javascript
JavaScript实现数字数组正序排列的方法
2015/04/06 Javascript
AngularJs  E2E Testing 详解
2016/09/02 Javascript
BootStrapTable 单选及取值的实现方法
2017/01/10 Javascript
VUE利用vuex模拟实现新闻点赞功能实例
2017/06/28 Javascript
Js自定义多选框效果的实例代码
2017/07/05 Javascript
浅谈开发eslint规则
2018/10/01 Javascript
解决Vue在封装了Axios后手动刷新页面拦截器无效的问题
2018/11/08 Javascript
jQuery实现适用于移动端的跑马灯抽奖特效示例
2019/01/18 jQuery
详解vuex数据传输的两种方式及this.$store undefined的解决办法
2019/08/26 Javascript
python对数组进行反转的方法
2015/05/20 Python
使用Python判断质数(素数)的简单方法讲解
2016/05/05 Python
在阿里云服务器上配置CentOS+Nginx+Python+Flask环境
2016/06/18 Python
浅析Python pandas模块输出每行中间省略号问题
2018/07/03 Python
python SQLAlchemy 中的Engine详解
2019/07/04 Python
python2使用bs4爬取腾讯社招过程解析
2019/08/14 Python
Python Pandas数据分析工具用法实例
2020/11/05 Python
加拿大最大的五金、家居装修和园艺产品商店:RONA
2017/01/27 全球购物
澳大利亚领先的宠物用品商店:VetSupply
2017/09/08 全球购物
意大利体育用品和运动服网上商店:Maxi Sport
2019/09/14 全球购物
5个HTML5的常用本地存储方式详解与介绍
2021/03/27 HTML / CSS
教师的实习自我鉴定
2013/12/17 职场文书
报关专员求职信范文
2014/02/22 职场文书
岗位说明书标准范本
2014/07/30 职场文书
教你怎么用Python实现多路径迷宫
2021/04/29 Python
Oracle更换为MySQL遇到的问题及解决
2021/05/21 Oracle
用React Native制作一个简单的游戏引擎
2021/05/27 Javascript
基于Redis zSet实现滑动窗口对短信进行防刷限流的问题
2022/02/12 Redis
vue3引入highlight.js进行代码高亮的方法实例
2022/04/08 Vue.js