使用Python3中的gettext模块翻译Python源码以支持多语言


Posted in Python onMarch 31, 2015

你写了一个Python 3程序,还想要它适用于其他语言。你能复制全部代码库,然后刻意地检查每个.py文件,替换掉所有找到的文本字符串。但这意味着你有两份你代码的独立副本,每当你要做出个改动或修复个bug,你的工作量会加倍。而且如果你想要程序还适用于其他语言,就更糟了。

幸运的是,Python给了一个解决办法,就是用gettext模块。
一个Hack解法

你应该把你自己的解决办法统一改变。例如,你可以把你程序中的每个字符串替换为一个函数调用(函数名简单些,比如像_()一样),这会返回被翻译为该正确语言的字符串。举个例子,如果你的程序原本是:
 

print('Hello world!')

……你可以将它改为:
 

print(_('Hello world!'))

……函数_()会返回'Hello world!'的翻译,它基于程序设置有的语言。比如,如果这个语言设置之前被存在一个叫LANGUAGE的全局变量中,函数_()看起来像这样:
 

def _(s):
  spanishStrings = {'Hello world!': 'Hola Mundo!'}
  frenchStrings = {'Hello world!': 'Bonjour le monde!'}
  germanStrings = {'Hello world!': 'Hallo Welt!'}
 
  if LANGUAGE == 'English':
    return s
  if LANGUAGE == 'Spanish':
    return spanishStrings[s]
  if LANGUAGE == 'French':
    return frenchStrings[s]
  if LANGUAGE == 'German':
    return germanStrings[s]

这可以,但是你这是在重复造轮子。Python的gettext模块可以做更多。gettext是一系列工具,文件格式在20世纪90年代被发明出来,来规范软件国际化(也叫I18N)。gettext是个作为对于所有编程语言的系统化的设计,但是我们会在本篇文章中只专注于Python。
程序例子

设想你有个想要翻译的用Python3写的简单“猜数字”游戏。程序的源代码在这里。有四步来使这个程序国际化:

    调整这个.py文件的源代码,这样使字符串输入进一个名为_()的函数。
    用和Python一起安装的pygettext.py文本,从源代码创建一个”pot”文件。
    用这个免费的跨平台Poedit软件,从pot文件创建.po和.mo文件。
    再次调整你的.py文件源代码导入gettext模块的代码,设置语言。

第一步:添加 _() 函数

首先,检查你程序中的所有需要被翻译和用_()的调用来替代的字符串。针对Python使用的gettext系统用_()作为得到翻译了的字符串的通用名,因为它是个短名。

注意:用格式型字符串而不是连接型字符串会是你的程序翻译起来更简单。例如,用连接型字符串你的程序会像这样:
 

print('Good job, ' + myName + '! You guessed my number in ' + guessesTaken + ' guesses!')
print(_('Good job, ') + myName + _('! You guessed my number in ') + guessesTaken + _(' guesses!'))

This results in three separate strings that need to be translated, as opposed to the single string needed in the string formatting approach:
这会导致三个独立的字符串都需要翻译,然而相反的是在格式型的字符串中,只需翻译一个字符串:

print('Good job, %s! You guessed my number in %s guesses!' % (myName, guessesTaken))
print(_('Good job, %s! You guessed my number in %s guesses!') % (myName, guessesTaken))

当你改完“猜数字”源代码后,它会像这样。你并不能运行它,因为_()函数还没定义。这个变化只是让pygettext.py文本可以找到所有需要翻译的字符串。
第二步:用pygettext.py提取字符串

在你Python安装(Windows上的C:Python34Toolsi18n)中的Tools/i18n就是pygettext.py文本。对于可译字符串普通 gettext unix 命令解析 C/C++ 源码并且 xgettext unix 命令可以解析其他语言,而pygettext.py则知道怎样去解析Python源码。它会找到所有字符串并产生个”pot”文件。

在Windows上我已经运行了这个文本像这样:
 

C:>py -3.4 C:Python34Toolsi18npygettext.py -d guess guess.py

这创建了一个pot文件,叫guess.pot。这只是个普通纯文本文件,它列出来了全部的在源码中寻找_()的调用的要翻译的字符串。你可以在这儿看guess.pot文件.
第三步:用Poedit翻译字符串

你可以用文本编辑器填写翻译但是免费的Poedit软件会更容易从这儿下载http://poedit.net. 选择 > New from POT/PO file… 然后选择你的guess.po文件。

使用Python3中的gettext模块翻译Python源码以支持多语言

Poedit会问你想要翻译成什么语言。我们举例用西班牙语:

使用Python3中的gettext模块翻译Python源码以支持多语言

填写翻译吧。(我用 http://translate.google.com,所以对于真的使用西班牙语的人会感觉有点奇怪。)

使用Python3中的gettext模块翻译Python源码以支持多语言

现在储存文件在它的gettext形式的文件夹里。保存会创建.po文件(一个人类可读的文本文件不同于原始.pot文件,除了是有西语翻译的)和一个.mo文件(一个gettext会读取的机器可读版本。这些文件会存在一个特定的文件夹内,为的是让gettext能够找到他们。他们看起来像这样(比如西语文件中的”es”和德语文件中”de”):
 

./guess.py
./guess.pot
./locale/es/LC_MESSAGES/guess.mo
./locale/es/LC_MESSAGES/guess.po
./locale/de/LC_MESSAGES/guess.mo
./locale/de/LC_MESSAGES/guess.po

这些两种性质的语言像西语中的”es”和德语中的 ”de” 被称作ISO 639-1 codes 是语言的标准缩写。你不一定要用他们,但是遵循标准是有道理的。
第四步:给你程序加上gettext代码

现在你有包含翻译的.mo文件,调整你的Python代码去用它。在你的程序中加上下面的:
 

import gettext
es = gettext.translation('guess', localedir='locale', languages=['es'])
es.install()

第一个 'guess' 是”定义域”,这其实是意味着guess.mo文件名中“猜”的部分。 localedir是你创建的locale文件夹的目录地址。这会是相对或绝对的路径。'es'描述在locale文件夹下面的文件。LC_MESSAGES文件夹是个标准名

install()方法会导致调用_()返回翻译为西语的字符串。如果你想回到原始的英语只需要分配一个lambda函数值给_,这会返回当时输入的字符串:
 

import gettext
es = gettext.translation('guess', localedir='locale', languages=['es'])
print(_('Hello! What is your name?')) # prints Spanish
 
_ = lambda s: s

你可以检查准备翻译的”Guess the Number”源码。如果你想要运行此程序,下载并解压这个压缩文件和它的locale文件夹和.mo安装文件。
延伸阅读

我怎样都称不上是 I18N or gettext的专家,如果我的教程讲解不够好,请一定要留言。大多数情况下,你的软件运行时不会转换语言,而是会去读LANGUAGE,LC_ALL,LC_MESSAGES,和LANG这些环境变量中的一个来确定计算机的工作地点。我会边学习边更新本教程的。

Python 相关文章推荐
python自动化测试之从命令行运行测试用例with verbosity
Sep 28 Python
使用Python中的greenlet包实现并发编程的入门教程
Apr 16 Python
python访问系统环境变量的方法
Apr 29 Python
在Python程序和Flask框架中使用SQLAlchemy的教程
Jun 06 Python
一个月入门Python爬虫学习,轻松爬取大规模数据
Jan 03 Python
python pcm音频添加头转成Wav格式文件的方法
Jan 09 Python
PyQt5固定窗口大小的方法
Jun 18 Python
python中如何使用insert函数
Jan 09 Python
python使用多线程查询数据库的实现示例
Aug 17 Python
python 实现朴素贝叶斯算法的示例
Sep 30 Python
python绘制雷达图实例讲解
Jan 03 Python
Pytorch中的数据集划分&正则化方法
May 27 Python
python根据出生日期获得年龄的方法
Mar 31 #Python
用Python进行一些简单的自然语言处理的教程
Mar 31 #Python
用Python制作在地图上模拟瘟疫扩散的Gif图
Mar 31 #Python
以一段代码为实例快速入门Python2.7
Mar 31 #Python
11个并不被常用但对开发非常有帮助的Python库
Mar 31 #Python
Python的Flask框架中@app.route的用法教程
Mar 31 #Python
使用Python的Flask框架实现视频的流媒体传输
Mar 31 #Python
You might like
上传多个文件的PHP脚本
2006/11/26 PHP
php用正则表达式匹配URL的简单方法
2013/11/12 PHP
摘自织梦CMS的HTTP文件下载类
2015/08/08 PHP
表单提交错误后返回内容消失问题的解决方法(PHP网站)
2015/10/20 PHP
PHP 枚举类型的管理与设计知识点总结
2020/02/13 PHP
JavaScript 浮点数运算 精度问题
2009/10/06 Javascript
JS构建页面的DOM节点结构的实现代码
2011/12/09 Javascript
ie7+背景透明文字不透明超级简单的实现方法
2014/01/17 Javascript
实现图片预加载的三大方法及优缺点分析
2014/11/19 Javascript
详解JavaScript基于面向对象之继承
2015/12/13 Javascript
JavaScript下的时间格式处理函数Date.prototype.format
2016/01/27 Javascript
sencha ext js 6 快速入门(必看)
2016/06/01 Javascript
JS基于HTML5的canvas标签实现炫目的色相球动画效果实例
2016/08/24 Javascript
Centos6.8下Node.js安装教程
2017/05/12 Javascript
vue中子组件调用兄弟组件方法
2018/07/06 Javascript
vue项目持久化存储数据的实现代码
2018/10/01 Javascript
vue使用svg文件补充-svg放大缩小操作(使用d3.js)
2020/09/22 Javascript
[02:25]DOTA2英雄基础教程 虚空假面
2014/01/02 DOTA
python用字典统计单词或汉字词个数示例
2014/04/22 Python
win7 下搭建sublime的python开发环境的配置方法
2014/06/18 Python
python解决js文件utf-8编码乱码问题(推荐)
2018/05/02 Python
在django中实现页面倒数几秒后自动跳转的例子
2019/08/16 Python
python 弧度与角度互转实例
2020/04/15 Python
python归并排序算法过程实例讲解
2020/11/04 Python
HTML5实现无刷新修改URL的方法
2019/11/14 HTML / CSS
美国全球旅游运营商:Pacific Holidays
2018/06/18 全球购物
怎样写演讲稿
2014/01/04 职场文书
四年级科学教学反思
2014/02/10 职场文书
人民教师的自我评价分享
2014/02/21 职场文书
搞笑婚礼主持词
2014/03/13 职场文书
2015新年联欢晚会开场白
2014/12/14 职场文书
辞职信格式范文
2015/05/13 职场文书
隐形的翅膀观后感
2015/06/10 职场文书
2016党员三严三实心得体会
2016/01/15 职场文书
详解Nginx启动失败的几种错误处理
2021/04/01 Servers
vue实现登陆页面开发实践
2022/05/30 Vue.js