在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中获取网页状态码的两个方法
Nov 03 Python
python使用7z解压apk包的方法
Apr 18 Python
python3+PyQt5 实现Rich文本的行编辑方法
Jun 17 Python
关于PyTorch 自动求导机制详解
Aug 18 Python
python实现的分析并统计nginx日志数据功能示例
Dec 21 Python
Win10里python3创建虚拟环境的步骤
Jan 31 Python
python内打印变量之%和f的实例
Feb 19 Python
python生成任意频率正弦波方式
Feb 25 Python
简单了解Java Netty Reactor三种线程模型
Apr 26 Python
Python基于httpx模块实现发送请求
Jul 07 Python
python实现磁盘日志清理的示例
Nov 05 Python
python中yield的用法详解
Jan 13 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
PHP5/ZendEngine2的改进
2006/10/09 PHP
PHP 采集程序原理分析篇
2010/03/05 PHP
PHP嵌套输出缓冲代码实例
2015/05/12 PHP
Symfony控制层深入详解
2016/03/17 PHP
PHP入门教程之面向对象基本概念实例分析
2016/09/11 PHP
PHP不使用递归的无限级分类简单实例
2016/11/05 PHP
利用PHP扩展Xhprof分析项目性能实践教程
2018/09/05 PHP
Jquery 基础学习笔记
2009/05/29 Javascript
写了10年的Javascript也未必全了解的连续赋值运算
2011/03/25 Javascript
javascript loadScript异步加载脚本示例讲解
2013/11/14 Javascript
jquery实现弹出窗口效果的实例代码
2013/11/28 Javascript
javascript在当前窗口关闭前检测窗口是否关闭
2014/09/29 Javascript
Jquery Ajax Error 调试错误的技巧
2015/11/20 Javascript
javascript创建cookie、读取cookie
2016/03/31 Javascript
几行js代码实现自适应
2017/02/24 Javascript
使用jQuery实现简单的tab框实例
2017/08/22 jQuery
VueJS组件之间通过props交互及验证的方式
2017/09/04 Javascript
bootstrap3中container与container_fluid外层容器的区别讲解
2017/12/04 Javascript
使用ajax的post同步执行(实现方法)
2017/12/21 Javascript
JS实现容器模块左右拖动效果
2020/01/14 Javascript
详解ES6 CLASS在微信小程序中的应用实例
2020/04/24 Javascript
Python 类的继承实例详解
2017/03/25 Python
python write无法写入文件的解决方法
2019/01/23 Python
用Python实现最速下降法求极值的方法
2019/07/10 Python
Python将string转换到float的实例方法
2019/07/29 Python
一文详述 Python 中的 property 语法
2020/09/01 Python
python实现简单的五子棋游戏
2020/09/01 Python
Agoda西班牙:全球特价酒店预订
2017/06/03 全球购物
智能电子秤、手表和健康监测仪:Withings(之前为诺基亚健康)
2018/10/30 全球购物
Myprotein丹麦官网:欧洲第一运动营养品牌
2019/04/15 全球购物
《中华少年》教学反思
2014/02/15 职场文书
财务情况说明书范文
2014/05/06 职场文书
餐饮店长岗位职责
2015/04/14 职场文书
详解Python牛顿插值法
2021/05/11 Python
Python机器学习之基础概述
2021/05/19 Python
使用 CSS 轻松实现一些高频出现的奇形怪状按钮
2021/12/06 HTML / CSS