XLIFF¶

备注

Weblate 当前支持 XLIFF 1.2。XLIFF 2.0 不受支持且不向后兼容 XLIFF 1.2。

基于 XML 的格式，为标准化翻译文件而生，但最终它也只是这个领域的众多标准之一。

XML Localization Interchange File Format (XLIFF) 通常用作双语言格式，但 Weblate 也支持其作为单语言格式。

Weblate 支持数种变体的 XLIFF：

XLIFF 1.2 翻译文件: 简单的 XLIFF 文件，其中元素的内容存储为纯文本（所有 XML 元素都被转义）。
`支持 placeables 的 XLIFF 1.2 `: 标准 XLIFF 支持可放置对象和其他 XML 元素。
带 gettext 扩展的 XLIFF 1.2: XLIFF 使用 XLIFF 1.2 Gettext PO 表示指南进行丰富，以支持复数。

参见

XML Localization Interchange File Format (XLIFF) 规范，XLIFF 1.2 Gettext PO 呈现指南, XLIFF 的维基百科条目, XLIFF

翻译状态¶

文件中的 state 属性在 Weblate 中被部分处理并映射为 “Needs edit” （需要编辑）的状态（如果出现目标的话，后面的状态用于将字符串标记为需要编辑： new 、 needs-translation 、 needs-adaptation 、 needs-l10n ）。如果应该省略 state 属性，只要 <target> 元素存在，那么字符串被认为需要翻译。

如果翻译字符串具有 approved="yes"，那么它还将作为“Approved”（已核准）导入 Weblate，其他的将作为 “Waiting for review”（待审校）导入（符合 XLIFF 规范）。

当存储时，Weblate 如无必要不会添加其它属性：

state 属性只在字符串标记为需要编辑的情况下添加。
approved 属性只在字符串已审校的情况下添加。
在其它情况下不添加属性，但在它们出现的情况下更新。

这意味着在使用 XLIFF 格式时，强烈推荐打开 Weblate 审校过程，以便查看和更改字符串的核准状态。

相似地在导入这样的文件时（在上传表单中），应该选择处理需要编辑的字符串之下的导入为已翻译。

参见

专门的审校员

XLIFF 中的空格和换行符¶

通常空格的类型和数量和在 XML 格式中的一样对待。如果想要保留，必须将 xml:space="preserve" 标记添加到字符串中。

例如：

    <trans-unit id="10" approved="yes">
        <source xml:space="preserve">hello</source>
        <target xml:space="preserve">Hello, world!
</target>
    </trans-unit>

指定翻译标记¶

还可以通过使用 weblate-flags 属性指定附加的翻译标记（请参见使用标记定制行为）。Weblate 还理解来自 XLIFF 规范的 maxwidth 和 font 属性：

<trans-unit id="10" maxwidth="100" size-unit="pixel" font="ubuntu;22;bold">
   <source>Hello %s</source>
</trans-unit>
<trans-unit id="20" maxwidth="100" size-unit="char" weblate-flags="c-format">
   <source>Hello %s</source>
</trans-unit>

解析 font 属性用于字体集、尺寸和粗细，上面的示例显示了全部，尽管只需要字符集。字符集中的任何空格被转换为下划线，所以 Source Sans Pro 变成 Source_Sans_Pro，当命名字符集时请记住这些请参见管理字型）。

参见

XLIFF 1.2 中的字体属性， XLIFF 1.2 中的 maxwidth 属性

字符串键¶

Weblate 通过 resname 属性（如果有的话）识别 XLIFF 文件中的单元，并会回退到 id （如果有的话，则与 file 标签一起）。

resname 属性被认为是人类友好的单元标识符，这也使其比 id 更适合 Weblate 显示。在整个 XLIFF 文件中 resname 必须是唯一的。这是 Weblate 的要求，XLIFF 标准没有涉及到这一点——它没有对此属性施加任何唯一性限制。

示例文件¶

示例 XLIFF 文件：

<?xml version='1.0' encoding='UTF-8'?>
<xliff xmlns="urn:oasis:names:tc:xliff:document:1.1">
    <file>
        <body>
            <trans-unit weblate-flags="c-format, max-length:100">
                <source xml:space="preserve">Hello, world!
</source>
            </trans-unit>
            <trans-unit>
                <source xml:space="preserve">Orangutan has %d banana.
</source>
            </trans-unit>
            <trans-unit>
                <source xml:space="preserve">Try Weblate at &lt;https://demo.weblate.org/&gt;!
</source>
            </trans-unit>
            <trans-unit>
                <source>Thank you for using Weblate.</source>
            </trans-unit>
        </body>
    </file>
</xliff>

Weblate 配置¶

用于双语言 XLIFF 的典型 Weblate 部件配置
文件掩码	`localizations/*.xliff`
单语言译文模版语言文件	空
新语种的翻译模版	`localizations/en-US.xliff`
文件格式	XLIFF 翻译文件

用于单语言 XLIFF 的典型 Weblate 部件配置
文件掩码	`localizations/*.xliff`
单语言译文模版语言文件	`localizations/en-US.xliff`
新语种的翻译模版	`localizations/en-US.xliff`
文件格式	XLIFF 翻译文件