16.2 从翻译说起
wxWidgets 是通过 wxLocale 来提供语言翻译支持的.而且它自己也已经被完整的支持了很多种语言.请从 wxWidgets 的官方网站下载最新的翻译包。
wxWidgets 提供的国际化语言支持和 GNU 的 gettext 工具包非常的相似.wxWidgets 使用的分类条目机制和 gettext 的分类条目机制是二进制兼容的,意味着你可以使用所有的 gettext 工具.并且在运行时不需要别的任何附加的库支持因为 wxWidgets 内部实现了对条目文件的读取。
在程序开发过程中,你需要 gettext 工具包来操作分类条目(或者 poEdit 工具,参考下面的小节).有两种类型的消息分类条目文件,一种是源文件,它是文本格式文件,扩展名为.po,另外一种是二进制分类条目文件,它是通过分类条目源文件使用 gettext 工具包中的工具 msgfmt 创建的,扩展名是.mo. 在程序运行过程中只需要二进制的分类条目文件.针对每一种你想要支持的语言,你都需要单独提供种分类条目文件。
poEdit
你不需要使用 gettext 提供的命令行工具来维护你的分类条目.Vaclav Slavik 制作了一个叫做 poEdit 的工具,它是一个图形化的 gettext 前端工具,可以从 http://www.poedit.org 下载.运行界面如下图所示.它可以用来帮助你维护分类条目,产生.mo 文件以及随着你的代码的更改和增加将新的需要翻译的条目合入旧的分类条目文件。
一步一步介绍创建消息翻译分类条目
遵循下面的这些步骤来进行某个消息条目的建立:
- 在你的代码中,将需要翻译的字符串常量使用 wxGettranslation 宏或者它的简短替代品_() 宏括起来.对于那些不需要翻译的字符串,也请使用 wxT() 或者等价的_T() 宏括起来,以便其可以实现 Unicode 兼容。
- 将你在代码中标识为需要翻译的字符串整理到.po 文件中.当然,这么负责的步骤你不需要使用手工去作它,你可以使用 gettext 工具包中的 xgettext 工具,然后使用"-k"参数指定到底翻译 wxGettranslation 宏还是_() 宏指代的字符串. poEdit 工具也可以帮你完成这个工作,和 xgettext 的"-k"参数等价的功能需要在配置对话框中指定。
- 将整理好的.po 文件中的字符串翻译为你希望使用的那种语言的字符串,每种语言对应一个.po 文件,并且要指定这种语言使用的编码方式。
如果没有使用 poEdit 工具,你可以使用任何你喜欢的文本编辑器来完成这个工作,对应的.po 文件的文件头如下所示:
# SOME DESCRIPTIVE TITLE. # Copyright (C) YEAR Free Software Foundation, Inc. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 1999-02-19 16:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=iso8859-1\n" "Content-Transfer-Encoding: 8bit\n"
注意倒数第二行的 charset 属性,指定了这个分类条目文件使用的编码方式.本文件中所有的字符串都将采用这种编码方式,这是非常重要的,因为如果你使用了非 Unicode 的编码而没有指定其编码方式,那些 GUI 控件将不知道怎样显示你翻译的文本。
- 将翻译好的.po 文件编译为二进制的.mo 文件.这要用到一个工具叫做 msgfmt,poEdit 也可以帮你完成这个工作. 使用 msgfmt 的命令行如下所示:
msgfmt -o myapp.mo myapp.po
- 在你的代码中设置合适的 locale 参数以便它使用对应的分类条目(我们将在接下来的小节,"使用 wxLocale"中介绍相关内容)。
在 Mac OS X 系统上,你还需要更改一个叫做 Info.plist 的文件,这个文件是用来描述你的软件包的相关信息的.它是一个使用 UTF-8 编码的 Xml 文件,其中包含一个叫做 CFBundleDevelopmentRegion 的条目用来描述软件的开发语言(比如说:英语),而 Mac OSX 将会查询软件包中某些默认路径来找到这个软件支持的语言.例如,如果存在目录 German.lproj,则认为这个软件支持德语.因为 wxWidgets 并不使用这样的目录名称,你需要在这个文件中显式的指定你的应用程序支持的语言类型.这可以通过在其中增加 CFBundleLocalizations 条目来实现,如下所示:
<key>CFBundleDevelopmentRegion</key>
<string>English</string>
<key>CFBundleLocalizations</key>
<array>
<string>en</string>
<string>de</string>
<string>fr</string>
</array>
使用 wxLocale
wxLocale 封装了所有和本地化相关的设置,类似于 C 语言中的 locale 的概念.通常你在你的应用程序类中定义一个 wxLocale 类型的成员,比如说:m_locale,然后在你的应用程序的 OnInit 函数中,象下面这样初始化这个变量:
if (m_locale.Init(wxLANGUAGE_DEFAULT,
wxLOCALE_LOAD_DEFAULT | wxLOCALE_CONV_ENCODING))
{
m_locale.AddCatalog(wxT("myapp"));
}
注意 wxLocale::Init 函数将会查找 wxstd.mo 文件,这个文件代表 wxWidgets 自己的翻译分类条目.参数 wxLANGUAGE_DEFAULT 指定使用系统默认的语言,你也可以通过使用对应的 wxLANGUAGE_xxx 宏来强制指定某种特定的语言。
当 wxLocale 加载一个翻译条目的时候,这个条目被自动从它自己的编码转换成系统当前使用的编码,这是 wxLocale 的默认行为,如果你不希望使用这个行为,你可以在调用 wxLocale::Init 时不传递 wxLOCALE_CONV_ENCODING 标记。
wxWidgets 在哪些目录里寻找对应的.mo 文件呢?对于任何一个待查目录<DIR>,它的查找范围包括下面的这些目录:
<DIR>/<LANG>/LC_MESSAGES
<DIR>/<LANG>
<DIR>
到底哪些目录是待查目录,依系统的不同各不相同:
- 在所有的平台上,LC_PATH 环境变量指定的目录将成为待查目录。
- 在 Unix 或 Mac OS X 上,wxWidgets 的安装路径将成为待查目录,另外还有/share/locale, /usr/share/locale, /usr/lib/locale, /usr/locale /share/locale 以及当前目录。
- 在 Windows 平台上,应用程序所在的目录也将成为待查目录。
你还可以通过函数 wxLocale::AddCatalogLookupPathPrefix 增加你自己的待查目录,比如:
wxString resDir = GetAppDir() + wxFILE_SEP_PATH + wxT("resources");
m_locale.AddCatalogLookupPathPrefix(resDir);
// 假设 resDir 是 c:\MyApp\resources, 假设当前使用法语,
// AddCatalog 将查找的待查目录除了前面介绍的所有待查目录外,
// 还将额外查找下面的路径:
//
// c:\MyApp\resources\fr\LC_MESSAGES\myapp.mo
// c:\MyApp\resources\fr\myapp.mo
// c:\MyApp\resources\myapp.mo
m_locale.AddCatalog(wxT("myapp"));
通常在发行你的应用程序的时候,你应该为每个语言创建一个子目录,目录名称使用代码某种区域的标准的国际化名称,然后在其中放置对应的 <appname>.mo.比如,wxWidgets 自带的 internat 例子程序将 ISO639 格式编码的法语和德语翻译文件分别放置在 fr 和 de 目录中。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论