在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脚本实现网卡流量监控
Feb 14 Python
python实现清屏的方法
Apr 30 Python
用python代码将tiff图片存储到jpg的方法
Dec 04 Python
PyQt5实现简单数据标注工具
Mar 18 Python
Django如何实现上传图片功能
Aug 16 Python
解决Pytorch 训练与测试时爆显存(out of memory)的问题
Aug 20 Python
python3.x 生成3维随机数组实例
Nov 28 Python
flask框架json数据的拿取和返回操作示例
Nov 28 Python
Python 动态变量名定义与调用方法
Feb 09 Python
python实现引用其他路径包里面的模块
Mar 09 Python
python中列表的含义及用法
May 26 Python
8种常用的Python工具
Aug 05 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来实现网络服务
2009/09/15 PHP
理解和运用PHP中的多态性[译]
2011/08/02 PHP
浅谈php中变量的数据类型判断函数
2017/03/04 PHP
PHP利用Cookie设置用户30分钟未操作自动退出功能
2017/07/03 PHP
javascript 面向对象编程基础 多态
2009/08/21 Javascript
基于jQuery的弹出消息插件 DivAlert之旅(一)
2010/04/01 Javascript
jquery动态添加删除div 具体实现
2013/07/20 Javascript
利用js实现在浏览器状态栏显示访问者在本页停留的时间
2013/12/29 Javascript
将HTML的左右尖括号等转义成实体形式的两种实现方式
2014/05/04 Javascript
JavaScript中split() 使用方法汇总
2015/04/17 Javascript
实现placeholder效果的方案汇总
2015/06/11 Javascript
深入学习AngularJS中数据的双向绑定机制
2016/03/04 Javascript
动态JavaScript所造成一些你不知道的危害
2016/09/25 Javascript
jQuery中on方法使用注意事项详解
2017/02/15 Javascript
JS使用正则表达式获取小括号、中括号及花括号内容的方法示例
2018/06/01 Javascript
解决vue脚手架项目打包后路由视图不显示的问题
2018/09/20 Javascript
微信小程序仿知乎实现评论留言功能
2018/11/28 Javascript
JS实现头条新闻的经典轮播图效果示例
2019/01/30 Javascript
vuecli3.x中轻松4步带你使用tinymce的步骤
2020/06/25 Javascript
[45:46]2014 DOTA2国际邀请赛中国区预选赛5.21 HGT VS DT
2014/05/23 DOTA
Flask SQLAlchemy一对一,一对多的使用方法实践
2013/02/10 Python
Python输出9*9乘法表的方法
2015/05/25 Python
Python中函数的参数定义和可变参数用法实例分析
2015/06/04 Python
keras 自定义loss损失函数,sample在loss上的加权和metric详解
2020/05/23 Python
2019史上最全Database工程师题库
2015/12/06 面试题
酒店拾金不昧表扬信
2014/01/18 职场文书
学校消防安全制度
2014/01/30 职场文书
三下乡活动方案
2014/01/31 职场文书
国际贸易专业个人求职信格式
2014/02/02 职场文书
2015年高考寄语或鼓励的话
2015/03/23 职场文书
2016元旦文艺汇演主持词
2015/07/06 职场文书
2016年师德学习心得体会
2016/01/12 职场文书
2016保送生自荐信范文
2016/01/29 职场文书
Go 自定义package包设置与导入操作
2021/05/06 Golang
Java中CyclicBarrier和CountDownLatch的用法与区别
2021/08/23 Java/Android
Python编写车票订购系统 Python实现快递收费系统
2022/08/14 Python