XLIFF

Обновляйте поддерживаемые целевые элементы XLIFF, сохраняя исходный текст и идентификаторы единиц перевода.

XLIFF хранит исходный текст, перевод и связывающие их идентификаторы. Обработчик файлов xliff переводит содержимое <source> в значения <target> в документах XLIFF 1.2 и 2.x. Он поддерживает обычный текст и встроенные коды, сохраняя исходный текст и идентификаторы единиц перевода для импорта в вашу систему перевода.

Поддерживаемые структуры единиц перевода #

В этой единице XLIFF 1.2 исходный текст не содержит разметки:

xml
<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.

Проверьте результат в программе, которую будете использовать для импорта. Сравните исходный текст, метаданные языка перевода, встроенные коды и полноту охвата сегментов. Проверьте повторяющиеся идентификаторы и единицы, намеренно исключённые из перевода, а затем — импортированный текст перевода.