XLIFF
Обновляйте поддерживаемые целевые элементы XLIFF, сохраняя исходный текст и идентификаторы единиц перевода.
XLIFF хранит исходный текст, перевод и связывающие их идентификаторы. Обработчик файлов xliff переводит содержимое <source> в значения <target> в документах XLIFF 1.2 и 2.x. Он поддерживает обычный текст и встроенные коды, сохраняя исходный текст и идентификаторы единиц перевода для импорта в вашу систему перевода.
Поддерживаемые структуры единиц перевода #
В этой единице XLIFF 1.2 исходный текст не содержит разметки:
<xliff version="1.2">
<file source-language="en" datatype="plaintext" original="checkout">
<body>
<trans-unit id="delivery">
<source>Choose delivery</source>
</trans-unit>
</body>
</file>
</xliff>В XLIFF 1.2 обработчик читает записи trans-unit, в том числе во вложенных группах. В 2.x — каждый unit и входящие в него записи segment. Если в единице несколько сегментов, каждый переводится отдельно.
Парные встроенные коды, например <g> и <pc>, сохраняют структуру, а текст внутри них переводится. Одиночные коды, например <ph>, остаются защищёнными от изменений. Сохраняйте идентификаторы единиц и встроенных кодов неизменными и уникальными. Единицы с повторяющимися идентификаторами сопоставляются по порядку появления, а несколько сегментов внутри единицы — по позиции. translate="no" исключает единицу или группу из перевода.
Целевые элементы и метаданные языка #
Документ формируется на основе текущего исходного файла. В неизменённых единицах можно сохранить существующий непустой перевод, если исходный текст и встроенные коды по-прежнему ему соответствуют. Если целевые элементы отсутствуют или пусты, нужен перевод. Для переведённых единиц, у которых ещё нет элементов <target>, обработчик создаёт их.
В выходном документе XLIFF 1.2 обработчик задаёт target-language каждого файла, а в 2.x — trgLang корневого элемента. При сериализации XML форматирование может измениться. При замене <target> записывается как новый элемент, поэтому проверьте не только текст, но и атрибуты, которые использует ваша программа импорта, а также статус проверки.
Как настроить и импортировать результат #
CLI определяет xliff по .xlf и .xliff. Выберите файлы с помощью конфигурации CLI или GitHub.
Проверьте результат в программе, которую будете использовать для импорта. Сравните исходный текст, метаданные языка перевода, встроенные коды и полноту охвата сегментов. Проверьте повторяющиеся идентификаторы и единицы, намеренно исключённые из перевода, а затем — импортированный текст перевода.