Gettext
翻译 PO 目标值,保留消息上下文和源消息标识,同时遵循复数重建的限制。
Gettext 将源文和译文保存在同一条目中。po 文件处理程序读取 msgid,将译文写入 msgstr,并保留源文。它还通过 msgctxt 区分不同场景下的相同词语。
通过上下文区分消息 #
例如,以下条目中的“Back”可以有不同的译法:
msgctxt "checkout navigation"
msgid "Back"
msgstr ""
msgctxt "product surface"
msgid "Back"
msgstr ""这些条目的 msgid 虽然相同,但仍是独立的单元。上下文也会作为翻译提示提供。注释行和标记行会随条目一并保留,但这并不意味着每条注释都会被解读为指令,也不意味着审核标记会被更新。
该解析器专门处理受支持的带引号 PO 字段及其续行。请使用 UTF-8 编码的输入;它不会转换任意旧式编码。自动发现 .pot 不在 CLI 的 .po 推断约定范围内。
复数重建的限制 #
对于复数条目,msgid 和 msgid_plural 会分别成为独立的单数和复数文本单元。处理程序至少会生成两个目标槽位。如果现有目标包含更多槽位,未更改的条目会保留已采纳的形式。当目标的前两种形式中任意一种发生变化时,额外槽位会填入新的复数值,而非各自独立生成的形式。
请在编译前审核复数输出。如果某种语言需要多种不同的形式,每个槽位都必须有正确的文本,并配有匹配的 Plural-Forms 头部。系统优先使用现有目标头部;首次输出时,会沿用源头部,并将其中的 Language 改为目标语言区域。处理程序不会针对目标语言重写 Plural-Forms。
更新与序列化 #
系统对照先前的源内容,根据上下文、消息标识以及单数或复数单元识别变更。现有目标条目提供需要保留的 msgstr 值。更改源消息标识可能会使消息被视为新消息,即使已采纳的目标译文仍然适用。
重建时会保留源字段、注释行和条目周围的布局,同时替换 msgstr 值及相关头部。带引号的译文值可能会被重新格式化。除了检查文件能否解析,还应验证消息数量和复数元数据。
配置并编译消息目录 #
CLI 根据 .po 推断 po。通过 CLI 配置或 GitHub 选择源消息目录。
使用应用的 Gettext 工具编译或导入输出,然后测试不同数量下的复数形式和特定上下文下的查找。即使解析成功,也应检查重复的复数值和头部:它们决定了应用在每种数量下显示的内容。