Pythongettext多语种国际化服务

NullTranslations 类¶

translation 类实际实现的是，将原始源文件消息字符串转换为已翻译的消息字符串。所有 translation 类使用的基类为 NullTranslations，它提供了基本的接口，可用于编写自己定制的 translation 类。以下是 NullTranslations 的方法：

class gettext.NullTranslations(fp=None)¶

接受一个可选参数 文件对象fp，该参数会被基类忽略。初始化由派生类设置的 "protected" （受保护的）实例变量 _info 和 _charset，与 _fallback 类似，但它是通过 add_fallback() 来设置的。如果 fp 不为 None，就会调用 self._parse(fp)。

_parse(fp)¶

在基类中没有操作，本方法接受文件对象 fp，从该文件读取数据，用来初始化消息编目。如果你手头的消息编目文件的格式不受支持，则应重写本方法来解析你的格式。

add_fallback(fallback)¶

添加 fallback 为当前 translation 对象的替补对象。如果 translation 对象无法为指定消息提供翻译，则应向替补查询。

gettext(message)¶

如果设置了替补，则转发 gettext() 给替补。否则返回 message。须在派生类中重写。

ngettext(singular, plural, n)¶

如果设置了替补，则转发 ngettext() 给替补。否则，n 为 1 时返回 singular，为其他时返回 plural。须在派生类中重写。

lgettext(message)¶

lngettext(singular, plural, n)¶

与 gettext() 和 ngettext() 等效，但是如果没有用 set_output_charset() 显式设置编码，则返回的翻译将以首选系统编码来编码字节串。在派生类中被重写。

警告

应避免在 Python 3 中使用这些方法。请参阅 lgettext() 函数的警告。

info()¶

返回 "protected"（受保护的） _info 变量，它是一个字典，包含在消息编目文件中找到的元数据。

charset()¶

返回消息编目文件的编码。

output_charset()¶

返回由 lgettext() 和 lngettext() 翻译的消息的编码。

set_output_charset(charset)¶

更改翻译出的消息的编码。

install(names=None)¶

本方法将 gettext() 安装至内建命名空间，并绑定为 _。

If the names parameter is given, it must be a sequence containing the

names of functions you want to install in the builtins namespace in

addition to _(). Supported names are 'gettext', 'ngettext',

'lgettext' and 'lngettext'.

注意，这仅仅是使 _() 函数在应用程序中生效的一种方法，尽管也是最方便的方法。由于它会影响整个应用程序全局，特别是内建命名空间，因此已经本地化的模块不应该安装 _()，而是应该用下列代码使 _() 在各自模块中生效:

importgettext
t=gettext.translation('mymodule',...)
_=t.gettext

这只将 _() 放在其模块的全局命名空间中，所以只影响其模块内的调用。

GNUTranslations 类¶

gettext 模块提供了一个派生自 NullTranslations 的其他类：GNUTranslations。该类重写了 _parse()，同时能以大端序和小端序格式读取 GNU gettext 格式的 .mo 文件。

GNUTranslations 从翻译编目中解析出可选的元数据。GNU gettext 约定，将元数据包括在空字符串的翻译中。该元数据采用 RFC 822 样式的 key:value 键值对，且应该包含 Project-Id-Version 键。如果找到 Content-Type 键，那么将用 charset 属性去初始化 "protected"（受保护的） _charset 实例变量，而该变量在未找到键的情况下默认为 None。如果指定了字符编码，那么从编目中读取的所有消息 ID 和消息字符串都将使用此编码转换为 Unicode，若未指定编码，则假定编码为 ASCII。

由于消息 ID 也是作为 Unicode 字符串读取的，因此所有 *gettext() 方法都假定消息 ID 为 Unicode 字符串，而不是字节串。

整个键/值对集合将被放入一个字典，并设置为 "protected"（受保护的） _info 实例变量。

如果 .mo 文件的魔法值 (magic number) 无效，或遇到意外的主版本号，或在读取文件时发生其他问题，则实例化 GNUTranslations 类会引发 OSError。

class gettext.GNUTranslations¶

下列方法是根据基类实现重写的：

gettext(message)¶

在编目中查找 message ID，并以 Unicode 字符串形式返回相应的消息字符串。如果在编目中没有 message ID 条目，且配置了替补，则查找请求将被转发到替补的 gettext() 方法。否则，返回 message ID。

ngettext(singular, plural, n)¶

查找消息 ID 的复数形式。singular 用作消息 ID，用于在编目中查找，同时 n 用于确定使用哪种复数形式。返回的消息字符串是 Unicode 字符串。

如果在编目中没有找到消息 ID，且配置了替补，则查找请求将被转发到替补的 ngettext() 方法。否则，当 n 为 1 时返回 singular，其他情况返回 plural。

例如：

n=len(os.listdir('.'))
cat=GNUTranslations(somefile)
message=cat.ngettext(
'There is %(num)d file in this directory',
'There are %(num)d files in this directory',
n)%{'num':n}

lgettext(message)¶

lngettext(singular, plural, n)¶

与 gettext() 和 ngettext() 等效，但是如果没有用 set_output_charset() 显式设置编码，则返回的翻译将以首选系统编码来编码字节串。

警告

应避免在 Python 3 中使用这些方法。请参阅 lgettext() 函数的警告。

Solaris 消息编目支持¶

Solaris 操作系统定义了自己的二进制 .mo 文件格式，但由于找不到该格式的文档，因此目前不支持该格式。

编目构造器¶

GNOME 用的 gettext 模块是 James Henstridge 写的版本，但该版本的 API 略有不同。它文档中的用法是:

importgettext
cat=gettext.Catalog(domain,localedir)
_=cat.gettext
print(_('hello world'))

为了与本模块的旧版本兼容，Catalog() 函数是上述 translation() 函数的别名。

本模块与 Henstridge 的模块有一个区别：他的编目对象支持通过映射 API 进行访问，但是该特性似乎从未使用过，因此目前不支持该特性。

本地化你的模块¶

如果要本地化模块，则切忌进行全局性的更改，如更改内建命名空间。不应使用 GNU gettext API，而应使用基于类的 API。

假设你的模块叫做 "spam"，并且该模块的各种自然语言翻译 .mo 文件存放于 /usr/share/locale，为 GNU gettext 格式。以下内容应放在模块顶部:

importgettext
t=gettext.translation('spam','/usr/share/locale')
_=t.gettext

importgettext
gettext.install('myapplication')

importgettext
gettext.install('myapplication','/usr/share/locale')

importgettext
lang1=gettext.translation('myapplication',languages=['en'])
lang2=gettext.translation('myapplication',languages=['fr'])
lang3=gettext.translation('myapplication',languages=['de'])
# start by using language1
lang1.install()
# ... time goes by, user selects language 2
lang2.install()
# ... more time goes by, user selects language 3
lang3.install()

animals=['mollusk',
'albatross',
'rat',
'penguin',
'python',]
# ...
forainanimals:
print(a)

def_(message):returnmessage
animals=[_('mollusk'),
_('albatross'),
_('rat'),
_('penguin'),
_('python'),]
del_
# ...
forainanimals:
print(_(a))

defN_(message):returnmessage
animals=[N_('mollusk'),
N_('albatross'),
N_('rat'),
N_('penguin'),
N_('python'),]
# ...
forainanimals:
print(_(a))