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文件以及随着你的代码的更改和增加将新的需要翻译的条目合入旧的分类条目文件.

一步一步介绍创建消息翻译分类条目

遵循下面的这些步骤来进行某个消息条目的建立:

  1. 在你的代码中,将需要翻译的字符串常量使用wxGettranslation宏或者它的简短替代品_()宏括起来.对于那些不需要翻译的字符串,也请使用wxT()或者等价的_T()宏括起来,以便其可以实现Unicode兼容.
  2. 将你在代码中标识为需要翻译的字符串整理到.po文件中.当然,这么负责的步骤你不需要使用手工去作它,你可以使用gettext工具包中的 xgettext工具,然后使用"-k"参数指定到底翻译wxGettranslation宏还是_()宏指代的字符串. poEdit工具也可以帮你完成这个工作,和xgettext的"-k"参数等价的功能需要在配置对话框中指定.

  3. 将整理好的.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 <[email protected]>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=iso8859-1\n"
"Content-Transfer-Encoding: 8bit\n"

    注意倒数第二行的charset属性,指定了这个分类条目文件使用的编码方式.本文件中所有的字符串都将采用这种编码方式,这是非常重要的,因为如果你使用了非Unicode的编码而没有指定其编码方式,那些GUI控件将不知道怎样显示你翻译的文本.

  4. 将翻译好的.po文件编译为二进制的.mo文件.这要用到一个工具叫做msgfmt,poEdit也可以帮你完成这个工作. 使用msgfmt的命令行如下所示:

    msgfmt -o myapp.mo myapp.po

  5. 在你的代码中设置合适的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目录中.