在Python的Django框架中创建语言文件


Posted in Python onJuly 27, 2015

当你标记了翻译字符串,你就需要写出(或获取已有的)对应的语言翻译信息。 这里就是它如何工作的。

地域限制

Django不支持把你的应用本地化到一个连它自己都还没被翻译的地域。 在这种情况下,它将忽略你的翻译文件。 如果你想尝试这个并且Django支持它,你会不可避免地见到这样一个混合体??参杂着你的译文和来自Django自己的英文。 如果你的应用需要你支持一个Django中没有的地域,你将至少需要做一个Django core的最小翻译。
消息文件

第一步,就是为一种语言创建一个信息文件。 信息文件是包含了某一语言翻译字符串和对这些字符串的翻译的一个文本文件。 信息文件以 .po 为后缀名。

Django中带有一个工具, bin/make-messages.py ,它完成了这些文件的创建和维护工作。 运行以下命令来创建或更新一个信息文件:

django-admin.py makemessages -l de

其中 de 是所创建的信息文件的语言代码。 在这里,语言代码是以本地格式给出的。 例如,巴西地区的葡萄牙语为 pt_BR ,澳大利亚地区的德语为 de_AT 。

这段脚本应该在三处之一运行:

  1.     Django项目根目录。
  2.     您Django应用的根目录。
  3.     django 根目录(不是Subversion检出目录,而是通过 $PYTHONPATH 链接或位于该路径的某处)。 这仅和你为Django自己创建一个翻译时有关。

这段脚本遍历你的项目源树或你的应用程序源树并且提取出所有为翻译而被标记的字符串。 它在 locale/LANG/LC_MESSAGES 目录下创建(或更新)了一个信息文件。针对上面的de,应该是locale/de/LC_MESSAGES/django.po。

作为默认, django-admin.py makemessages 检测每一个有 .html 扩展名的文件。  以备你要重载缺省值,使用 --extension 或 -e 选项指定文件扩展名来检测。

django-admin.py makemessages -l de -e txt

用逗号和(或)使用-e或--extension来分隔多项扩展名:

django-admin.py makemessages -l de -e html,txt -e xml

当创建JavaScript翻译目录时,你需要使用特殊的Django域:not -e js 。

没有gettext?

如果没有安装 gettext 组件, make-messages.py 将会创建空白文件。 这种情况下,安装 gettext 组件或只是复制英语信息文件( conf/locale/en/LC_MESSAGES/django.po )来作为一个起点;只是一个空白的翻译信息文件而已。

工作在Windows上么?

如果你正在使用Windows,且需要安装GNU gettext共用程序以便 django-admin makemessages 可以工作,请参看下面Windows小节中gettext部分以获得更多信息。

.po 文件格式很直观。 每个 .po 文件包含一小部分的元数据,比如翻译维护人员的联系信息,而文件的大部分内容是简单的翻译字符串和对应语言翻译结果的映射关系的列表。

举个例子,如果Django应用程序包括一个 "Welcome to my site." 的待翻译字符串 ,像这样:

_("Welcome to my site.")

则django-admin.py makemessages将创建一个 .po 文件来包含以下片段的消息:

#: path/to/python/module.py:23
msgid "Welcome to my site."
msgstr ""

快速解释:

  •     msgid 是在源文件中出现的翻译字符串。 不要做改动。
  •     msgstr 是相应语言的翻译结果。 刚创建时它只是空字符串,此时就需要你来完成它。 注意不要丢掉语句前后的引号。
  •     作为方便之处,每一个消息都包括:以 # 为前缀的一个注释行并且定位上边的msgid 行,文件名和行号。

对于比较长的信息也有其处理方法。 msgstr (或 msgid )后紧跟着的字符串为一个空字符串。 然后真正的内容在其下面的几行。 这些字符串会被直接连在一起。 同时,不要忘了字符串末尾的空格,因为它们会不加空格地连到一起。

若要对新创建的翻译字符串校验所有的源代码和模板,并且更新所有语言的信息文件,可以运行以下命令:

django-admin.py makemessages -a

编译信息文件

创建信息文件之后,每次对其做了修改,都需要将它重新编译成一种更有效率的形式,供 gettext 使用。可以使用django-admin.py compilemessages完成。

这个工具作用于所有有效的 .po 文件,创建优化过的二进制 .mo 文件供 gettext 使用。在你可以运行django-admin.py makemessages的目录下,运行django-admin.py compilemessages:

django-admin.py compilemessages

就是这样了。 你的翻译成果已经可以使用了。

编译信息文件

创建信息文件之后,每次对其做了修改,都需要将它重新编译成一种更有效率的形式,供 gettext 使用。可以使用django-admin.py compilemessages完成。

这个工具作用于所有有效的 .po 文件,创建优化过的二进制 .mo 文件供 gettext 使用。在你可以运行django-admin.py makemessages的目录下,运行django-admin.py compilemessages:

django-admin.py compilemessages

就是这样了。 你的翻译成果已经可以使用了。

Python 相关文章推荐
Python简单实现Base64编码和解码的方法
Apr 29 Python
Python 自动化表单提交实例代码
Jun 08 Python
python 中if else 语句的作用及示例代码
Mar 05 Python
Vue的el-scrollbar实现自定义滚动
May 29 Python
Python 常用模块 re 使用方法详解
Jun 06 Python
python 实现的发送邮件模板【普通邮件、带附件、带图片邮件】
Jul 06 Python
python实现桌面托盘气泡提示
Jul 29 Python
获取Pytorch中间某一层权重或者特征的例子
Aug 17 Python
Python列表操作方法详解
Feb 09 Python
Python txt文件如何转换成字典
Nov 03 Python
Python图像读写方法对比
Nov 16 Python
Python中的嵌套循环详情
Mar 23 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
Python计算已经过去多少个周末的方法
Jul 25 #Python
You might like
php安全配置 如何配置使其更安全
2011/12/16 PHP
PHP创建多级目录的两种方法
2016/10/28 PHP
PHP实现数组向任意位置插入,删除,替换数据操作示例
2019/04/05 PHP
JS模拟多线程
2007/02/07 Javascript
javascript css在IE和Firefox中区别分析
2009/02/18 Javascript
关于javascript function对象那些迷惑分析
2011/10/24 Javascript
js获取元素外链样式的方法
2015/01/27 Javascript
浅谈jQuery的offset()方法及示例分享
2015/07/17 Javascript
JavaScript图片轮播代码分享
2015/07/31 Javascript
通过正则表达式获取url中参数的简单实现
2016/06/07 Javascript
Boostrap基础教程之JavaScript插件篇
2016/09/08 Javascript
jQuery实现的右下角广告窗体跟随效果示例
2016/09/16 Javascript
RGB和YUV 多媒体编程基础详细介绍
2016/11/04 Javascript
js querySelector() 使用方法
2016/12/21 Javascript
jQuery基于ajax实现页面加载后检查用户登录状态的方法
2017/02/10 Javascript
js实现简单的获取验证码按钮效果
2017/03/03 Javascript
详解创建自定义的Angular Schematics
2018/06/06 Javascript
详解从vue-loader源码分析CSS Scoped的实现
2019/09/23 Javascript
[49:54]Ti4 循环赛第三日 LGD vs Titan
2014/07/12 DOTA
使用IronPython把Python脚本集成到.NET程序中的教程
2015/03/31 Python
python实现根据ip地址反向查找主机名称的方法
2015/04/29 Python
python类:class创建、数据方法属性及访问控制详解
2016/07/25 Python
在Python中表示一个对象的方法
2019/06/25 Python
python使用mitmproxy抓取浏览器请求的方法
2019/07/02 Python
Pycharm和Idea支持的vim插件的方法
2020/02/21 Python
Python如何使用27行代码绘制星星图
2020/07/20 Python
PyTorch预训练Bert模型的示例
2020/11/17 Python
如何通过python检查文件是否被占用
2020/12/18 Python
python 逆向爬虫正确调用 JAR 加密逻辑
2021/01/12 Python
巴黎卡诗美国官方网站:始于1964年的头发头皮护理专家
2017/07/10 全球购物
新品发布会主持词
2014/04/02 职场文书
村抢险救灾方案
2014/05/09 职场文书
党员评议思想汇报
2014/10/08 职场文书
涉外离婚协议书怎么写
2014/11/20 职场文书
2015年上半年信访工作总结
2015/03/30 职场文书
nginx优化的六点方法
2021/03/31 Servers