使用gettext进行本地化¶

除了：csv格式的ref：Doc_Importing_Translations`外，Godot还支持加载GNU gettext(`.po``)格式的翻译文件。

注解

有关GetText的介绍，请查看`A Quick GetText Tutorial<https://www.labri.fr/perso/fleury/posts/programming/a-quick-gettext-tutorial.html>`_.它是在考虑C项目的情况下编写的，但是很多建议也适用于Godot(除了``xgettext``)。

优势¶

GetText是一种标准格式，可以使用任何文本编辑器或图形用户界面编辑器(如`Poedit<https://poedit.net/>`_.)进行编辑。
翻译平台支持GetText，如`Tranapfex<https://www.transifex.com/>`_和`Weblate<https://weblate.org/>`_，，使得人们协作本地化变得更容易。
与CSV相比，gettext更适合Git这样的版本控制系统，因为每个语言环境都有自己的消息文件。
与CSV文件相比，在gettext文件中编辑多行字符串更方便。

缺点¶

Gettext是一种比CSV更复杂的格式，对于刚接触软件本地化的人来说可能更难理解。
维护本地化文件的人员必须在其系统上安装gettext工具。但是，由于Godot不使用编译的消息对象文件(.mo)，因此翻译人员无需安装gettext工具即可测试他们的工作。

注意事项¶

由于Godot在幕后使用自己的PO文件解析器(这比参考GNU gettext实现有更多限制)，因此不支持诸如多元化之类的一些特性。

安装gettext工具¶

需要命令行gettext工具来执行维护操作，如更新消息文件。因此，强烈建议您安装它们。

**windows：**从`本页<https://mlocati.github.io/articles/gettext-iconv-windows.html>`_.下载安装程序任何体系结构和二进制类型(共享或静态)都可以工作；如果有疑问，请选择64位静态安装程序。
macOS: 通过 BREW install gettext 命令使用 Homebrew 安装getText。
Linux: 在大多数发行版上，请从发行版的包管理器安装 gettext 包。

手动创建(POT)模板¶

Godot目前不支持使用``xgettext``提取源字符串，因此必须手动创建``.pot`文件。该文件可以放在项目目录中的任何位置，但建议将其放在子目录中，因为每个语言环境都将在其自己的文件中定义。

在工程目录下创建名为`locale`的目录。在该目录下，保存一个名为``messages.pot``的文件，内容如下：

# Don't remove the two lines below, they're required for gettext to work correctly.
msgid ""
msgstr ""

msgid "Hello world!"
msgstr ""

Gettext中的消息由``msgid``和``msgstr``对组成。``msgid``为源字符串(一般为英文)，``msgstr``为翻译后的字符串。

PO模板文件(.pot)中的``msgstr``值应**始终**为空。而是在生成的``.po``文件中进行本地化。

使用pybabel创建PO模板 (POT)¶

Python工具pybabel支持Godot，可用于从场景文件和脚本自动创建和更新POT文件。

安装``Babel`和``babel-godot``后，例如使用pip：

pip install babel babel-godot

编写一个映射文件(例如``Babelrc``)，指明pybabel需要处理哪些文件(请注意，我们将GDScript作为Python处理，这通常就足够了)：

[python: **.gd]
encoding = utf-8

[godot_scene: **.tscn]
encoding = utf-8

然后，您可以运行pybabel，如下所示：

pybabel extract -F babelrc -k text -k LineEdit/placeholder_text -k tr -o godot-l10n.pot .

使用 -k 选项指定需要提取的内容。在这种情况下，将翻译 tr() 的参数，以及名为“text”(控制节点常用)的属性和LineEdit的 placeholder_text 属性。

从PO模板创建消息文件¶

``msginit``命令用于将采购订单模板转换为消息文件。例如，要创建法语本地化文件，请在``locale``目录中使用以下命令：

msginit --no-translator --input=messages.pot --locale=fr

上面的命令会在采购订单模板所在的目录下创建一个名为``fr.po``的文件。

或者，您可以使用Poedit以图形方式完成此操作，或者通过将POT文件上传到您选择的Web平台。

Loading a messages file in Godot¶

若要在工程中将消息文件注册为翻转，请打开**Project Settings工程设置**, 然后进入**Localization本地化** 选项. 在**Translations翻转**, 单击**Add…添加然后在文件对话框中选择``.po`` 文件区域设置将从消息文件中的``"Language: <code>n"`` 属性中推算出来。

注解

See 使游戏国际化 for more information on importing and testing translations in Godot.

消息更新文件遵循PO模板¶

更新PO模板后，您必须更新消息文件以使其包含新字符串，同时删除在PO模板中不存在的字符串。这可以使用``msgmerge``工具自动完成：

# The order matters: specify the message file *then* the PO template!
msgmerge --update --backup=none fr.po messages.pot

If you want to keep a backup of the original message file (which would be saved as fr.po~ in this example), remove the --backup=none argument.

检查PO文件或模板的有效性¶

可以通过运行以下命令来检查gettext文件的语法是否有效：

msgfmt fr.po --check

如果有语法错误或警告,他们将显示在控制台，否则,“msgfmt“不会输出任何东西。