在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中的模块导入和读取键盘输入的方法
Oct 16 Python
Python调用C++程序的方法详解
Jan 24 Python
Python新手们容易犯的几个错误总结
Apr 01 Python
Python cookbook(数据结构与算法)在字典中将键映射到多个值上的方法
Feb 18 Python
python os用法总结
Jun 08 Python
Selenium的使用详解
Oct 19 Python
pycharm debug功能实现跳到循环末尾的方法
Nov 29 Python
Python直接赋值、浅拷贝与深度拷贝实例分析
Jun 18 Python
解决Python内层for循环如何break出外层的循环的问题
Jun 24 Python
Python函数中参数是传递值还是引用详解
Jul 02 Python
OpenCV+face++实现实时人脸识别解锁功能
Aug 28 Python
python之array赋值技巧分享
Nov 28 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作为网站开发语言的原因分享
2012/01/03 PHP
ajax php传递和接收变量实现思路及代码
2012/12/19 PHP
一个比较不错的PHP日历类分享
2014/11/18 PHP
学习php设计模式 php实现单例模式(singleton)
2015/12/07 PHP
4种PHP异步执行的常用方式
2015/12/24 PHP
php的laravel框架快速集成微信登录的方法
2016/12/12 PHP
PHP文件上传、客户端和服务器端加限制、抓取错误信息、完整步骤解析
2017/01/12 PHP
(function(){})()的用法与优点
2007/03/11 Javascript
jquery遍历筛选数组的几种方法和遍历解析json对象
2013/12/13 Javascript
JavaScript通过元素的ID和name设置样式
2014/07/08 Javascript
JavaScript闭包函数访问外部变量的方法
2014/08/27 Javascript
jquery实现点击页面计算点击次数
2015/01/23 Javascript
js实现仿微博滚动显示信息的效果
2015/12/21 Javascript
node.js文件上传处理示例
2016/10/27 Javascript
解决vue net :ERR_CONNECTION_REFUSED报错问题
2020/08/13 Javascript
python实现ipsec开权限实例
2014/11/11 Python
python数据类型_元组、字典常用操作方法(介绍)
2017/05/30 Python
Python 判断 有向图 是否有环的实例讲解
2018/02/01 Python
用python实现对比两张图片的不同
2018/02/05 Python
Python Series从0开始索引的方法
2018/11/06 Python
在pycharm 中添加运行参数的操作方法
2019/01/19 Python
对python中url参数编码与解码的实例详解
2019/07/25 Python
Python将二维列表list的数据输出(TXT,Excel)
2020/04/23 Python
Python 利用OpenCV给照片换底色的示例代码
2020/08/03 Python
python 发送get请求接口详解
2020/11/17 Python
美国床垫连锁店:Mattress Firm
2021/02/13 全球购物
酒店管理毕业生自荐信
2013/10/24 职场文书
工业设计专业推荐信
2013/10/29 职场文书
高三家长寄语
2014/04/03 职场文书
科级干部群众路线教育实践活动个人对照检查材料
2014/09/19 职场文书
学校施工安全责任书
2015/01/29 职场文书
2015年房地产个人工作总结
2015/05/26 职场文书
爱岗敬业事迹材料
2019/06/20 职场文书
电子表的操作介绍说明书
2019/10/28 职场文书
JDBC连接的六步实例代码(与mysql连接)
2021/05/12 MySQL
2021年国漫热度排行前十,完美世界上榜,第四是美国动画作品
2022/03/18 国漫