在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的描述符(descriptor)、装饰器(property)造成的一个无限递归问题分享
Jul 09 Python
Python中dictionary items()系列函数的用法实例
Aug 21 Python
初步解析Python下的多进程编程
Apr 28 Python
Python实现多线程HTTP下载器示例
Feb 11 Python
scrapy spider的几种爬取方式实例代码
Jan 25 Python
Python3基于sax解析xml操作示例
May 22 Python
Python设计模式之解释器模式原理与用法实例分析
Jan 10 Python
Python代码实现删除一个list里面重复元素的方法
Apr 02 Python
python3.4+pycharm 环境安装及使用方法
Jun 13 Python
Python qrcode 生成一个二维码的实例详解
Feb 12 Python
详解python 内存优化
Aug 17 Python
解决python便携版无法直接运行py文件的问题
Sep 01 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扩展ZF――Validate扩展
2008/01/10 PHP
php表单转换textarea换行符的方法
2010/09/10 PHP
thinkphp在php7环境下提示Cannot use ‘String’ as class name as it is reserved的解决方法
2016/09/30 PHP
PHP实现小偷程序实例
2016/10/31 PHP
php创建类并调用的实例方法
2019/09/25 PHP
Javascript remove 自定义数组删除方法
2009/10/20 Javascript
JS打开新窗口的2种方式
2013/04/18 Javascript
JS HTML5 音乐天气播放器(Ajax获取天气信息)
2013/05/26 Javascript
JS表的模拟方法
2015/02/05 Javascript
Javascript中的方法和匿名方法实例详解
2015/06/13 Javascript
AngularJS教程之简单应用程序示例
2016/08/16 Javascript
扩展jquery easyui tree的搜索树节点方法(推荐)
2016/10/28 Javascript
javascript过滤数组重复元素的实现方法
2017/05/03 Javascript
小程序点赞收藏功能的实现代码示例
2018/09/07 Javascript
node+express框架中连接使用mysql(经验总结)
2018/11/10 Javascript
微信小程序与后台PHP交互的方法实例分析
2018/12/10 Javascript
微信小程序自定义多列选择器使用详解
2019/06/21 Javascript
javascript事件循环event loop的简单模型解释与应用分析
2020/03/14 Javascript
Vue项目vscode 安装eslint插件的方法(代码自动修复)
2020/04/15 Javascript
JavaScript中跨域问题的深入理解
2021/03/04 Javascript
[15:56]Heroes18_暗影萨满(完美)
2014/10/31 DOTA
Python访问纯真IP数据库脚本分享
2015/06/29 Python
windows 10下安装搭建django1.10.3和Apache2.4的方法
2017/04/05 Python
python遍历文件夹下所有excel文件
2018/01/03 Python
Python %r和%s区别代码实例解析
2020/04/03 Python
Python3使用Selenium获取session和token方法详解
2021/02/16 Python
eDreams葡萄牙:全球最大的在线旅行社之一
2019/04/15 全球购物
是否可以从一个static方法内部发出对非static方法的调用?
2014/08/18 面试题
银行财务部实习生的自我鉴定
2013/11/27 职场文书
村捐赠仪式答谢词
2014/01/21 职场文书
餐饮企业总经理岗位职责范文
2014/02/18 职场文书
心理健康日活动总结
2014/05/08 职场文书
学校党委副书记个人对照检查材料思想汇报
2014/09/28 职场文书
2015年七夕爱情寄语
2015/03/24 职场文书
2015年安全工作总结范文
2015/04/02 职场文书
新手入门Mysql--概念
2021/06/18 MySQL