.XLIFF 1.2 и 2.0 — формат обмена данными локализации на основе XML (TMS)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

В редакторе содержимое тегов исходного файла можно просмотреть, выбрав «Развернуть теги» в меню «Инструменты», а затем отредактировать, нажав F2.

Включите проверку XLIFF при настройке контроля качества, чтобы избежать нарушения структуры файла.

Важно

Проблемы с тегами являются распространенной причиной ошибок при экспорте. Перед экспортом файлов всегда проверяйте правильность тегов и форматирования с помощью проверок качества.

Типы файлов

.XLF
.XLIFF
Только для версии 2.0

Файлы с заголовком <xliff version="2.0">

Параметры импорта

Разобрать сообщения ICU

Сообщения ICU автоматически конвертируются в теги. Если сегмент содержит встроенные элементы, синтаксический анализ ICU для этого сегмента пропускается. Сегменты без встроенных элементов анализируются обычным образом.
Использовать подфильтр HTML

Импортируются HTML теги, содержащиеся в файле. Далее теги можно использовать с настройками импорта файлов HTML.

Если включен подфильтр HTML, имена тегов, не входящие в список распознаваемых по умолчанию встроенных элементов HTML (стандартные встроенные элементы, такие как span, a и em), не преобразуются в защищенные встроенные теги. Вместо этого они рассматриваются как элементы, определяющие границы сегментов, или как блочные элементы. Сюда относятся пользовательские теги и псевдотеги, используемые для обрамления текста в исходном содержимом, например тег с именем link, обрамляющий фрагмент текста.

В результате открывающие и закрывающие маркеры такого тега не отображаются внутри какого-либо отдельного сегмента в Редакторе. Вместо этого сегмент разбивается на границе тега. Исходное содержимое и обрамленный тегом текст не исчезают из файла, но данные тега нельзя восстановить в виде встроенного тега, поскольку он изначально не был распознан как таковой.

Чтобы сохранить пользовательский или нестандартный тег как защищённый встроенный тег в пределах одного сегмента, добавьте его имя в раздел «Переводимые встроенные элементы» в «Настройках импорта файлов HTML» для этого типа файла. Этот параметр также можно настроить в шаблоне проекта, чтобы он автоматически применялся к проектам, созданным на основе этого шаблона.
Импортировать < примечание >

Данные из элемента <note> будут отображаться в окне «Контекст».

Поддерживается только <note> в <unit> (в соответствии со стандартами XLIFF 2.0).
Сохранить подтвержденные сегменты в TM при импорте

Сегменты, импортированные со статусом Подтверждено, сохраняются в памяти переводов проекта в режиме записи.
Сегмент XLIFF

Применяется стандартная сегментация. Если этот параметр не выбран, каждый элемент будет отдельным сегментом. Это может привести к появлению нескольких предложений в одном сегменте. Если этот параметр выбран, но элемент остается одним сегментом, в файле может присутствовать атрибут canResegment="no". Чтобы принудительно выполнить сегментацию, измените этот атрибут на "yes". Если атрибут canResegment="no" отсутствует, единица будет сегментирована.

Если сегмент target не пуст, текст в элементе source не сегментируется. Это поведение нельзя изменить, включая или отключая параметр «Сегментировать XLIFF» либо изменяя правила сегментации.

Если импортированный элемент unit содержит элементы segment в исходном файле, он не сегментируется дальше, поскольку считается уже сегментированным. Это поведение нельзя изменить, включая или отключая параметр «Сегментировать XLIFF». Сегментация возможна только в том случае, если элемент unit содержит один элемент segment и не содержит игнорируемых элементов.
Расшифровать теги разрыва строки/страницы

Теги разрыва строки и разрыва страницы XLIFF создают новые сегменты. Этот параметр будет применен только в том случае, если также включен параметр Сегментировать XLIFF.
Не удалять пробелы
Копировать исходный текст в пустую ячейку перевода, если сегмент не импортирован
Перезаписать значения перевода XLIFF

Если этот параметр включен, значения целевого языка из загруженного файла игнорируются и заменяются значениями целевого языка задания.
Формат языкового кода

Управляет регистром кода целевого языка, записываемого в заголовок готового файла. Этот параметр применяется только тогда, когда включен параметр «Переопределить целевые значения XLIFF».

Доступные варианты
- RFC в нижнем регистре, например fr-ca (по умолчанию)
- RFC, например fr-CA
- Стандарт Phrase, например fr_ca
- Android, например fr-rCA
- Android BCP, например b+fr+CA
Только для версии 2.0 Представлять текст с атрибутом «translate=no» в виде непереводимых тегов
Только для версии 1.2 Контекстное примечание

Контекст должен находиться либо в элементе context-group внутри trans-unit, либо в элементе context с атрибутом context-type.
Только для версии 2.0 Контекстный ключ

Контекст должен находиться в элементе unit или в потомках элемента unit. Базовым узлом (контекстным узлом) для вычисления XPath является элемент unit. XPath по умолчанию: @id.

Примечание

XPath контекстного ключа и пространства имён XML

Элементы XLIFF 2.0 находятся в пространстве имён XML, поэтому выражения XPath контекстного ключа, непосредственно ссылающиеся на имена элементов, могут не работать. Если выражение не возвращает результатов, используйте вместо этого функцию local-name().

Например, чтобы извлечь элемент <note> с category="key", используйте:

*[local-name()='notes']/*[local-name()='note' and @category='key']
Преобразовать в теги системы Phrase TMS
Преобразование в символьные сущности

Необходимые в выходном файле ссылки на символы, перечисленные через запятую.

Пример:

 ,&#x3A3;

Правила импорта сегментов

Добавление правил изменяет настройки импорта по умолчанию. Правила можно добавлять и сочетать друг с другом, а применять — с помощью доступной формы или вручную. Поддерживаются пользовательские состояния XLIFF. Разделение аргументов запятой задаёт логическую связь AND, а разделение новой строкой — логическую связь OR.

XPath также можно использовать в правилах, но выражение будет вычисляться относительно каждого элемента trans-unit (т. е. не относительно документа).

Примеры:

Импортировать только те сегменты, в которых элемент <trans-unit> имеет атрибут resname со значением info: .[contains(@resname,'info')] или значением, содержащим info.
Импортировать только те сегменты, в которых у элемента <trans-unit> нет такого дочернего элемента segment-metadata, у которого атрибут tm_match равен или содержит 100.00: .[not(contains(segment-metadata/@tm_match,'100.00'))]

Чтобы исключить из импорта совпадения на 100.00 % и 101.00 %, используйте or следующим образом: .[not(contains(segment-metadata/@tm_match,'100.00') or contains(segment-metadata/@tm_match,'101.00'))].

XPath также можно использовать в правилах, например, при импорте сегментов .[contains(@resname, 'info;yes')].

По умолчанию импортируются все элементы trans-unit файла XLIFF. Если выполняется сегментация, <source> сегментируется, а <seg-source> — нет. После импорта сегменты не подтверждены и не заблокированы.

Пользовательские настройки импорта

Не следует импортировать сегмент, если
Установить статус сегмента «подтвержденный», если
Установить статус сегмента «заблокированный», если

Сопоставление атрибутов экспорта

Добавление правил изменяет настройки импорта по умолчанию. Правила можно комбинировать или добавлять, а также применять с помощью доступной формы или вручную. Поддерживаются пользовательские состояния XLIFF.

По умолчанию все элементы trans-unit в экспортируемом целевом файле XLIFF будут выглядеть так же, как в исходном файле, за исключением того, что целевой текст будет переведён. Чтобы изменить состояния XLIFF, статусы сегментов можно сопоставить с состояниями XLIFF.

Например:

С Новый на Переведено в экспортируемом целевом файле XLIFF.

Пользовательские настройки экспорта

Конкретные целевые атрибуты можно сопоставить на основе следующих статусов сегментов:

Подтвержден и заблокирован
Подтвержден, но не заблокирован
Не подтвержден, но заблокирован
Не подтвержден и не заблокирован

Максимальная длина целевого текста

Если единицу разделить на несколько сегментов, у всех сегментов будет одинаковое значение свойства максимальной длины. Это значение будет равно максимальной длине единицы.

В этом случае после импорта возвращается следующее предупреждение:

Если единица разделена на несколько сегментов, ограничение максимальной длины проверяется для каждого сегмента отдельно.

1.2

Атрибут maxwidth можно использовать для указания максимальной длины перевода в следующих условиях:

Maxwidth должен находиться в элементе trans-unit (а не в группе).
Размер необходимо указать с помощью size-unit="char" или size-unit="percent".
В элементе trans-unit есть только один сегмент.

Предупреждение отображается, если в элементе trans-unit больше одного сегмента.

2.0

Функция максимальной длины перевода поддерживается только в том случае, если:

Элемент file содержит slr:profiles с generalProfile="xliff:codepoints"
Единица в файле содержит атрибут sizeRestriction.

Затем это максимальное значение задаётся как значение свойства максимальной длины сегмента.

Примечание

Если включен подфильтр HTML, имена тегов, не входящие в список распознаваемых по умолчанию встроенных элементов HTML (стандартные встроенные элементы, такие как span, a и em), не преобразуются в защищенные встроенные теги. Вместо этого они рассматриваются как элементы, обозначающие границы сегментов, или как блочные элементы. Это также относится к пользовательским или нестандартным именам тегов, используемых для обрамления текста в исходном контенте, например к тегу с именем link, обрамляющему фрагмент текста.

В результате открывающие и закрывающие маркеры такого тега не отображаются ни в одном отдельном сегменте в «Редакторе». Вместо этого сегмент разбивается на границе тега. Исходное содержимое и обрамлённый текст сохраняются в файле, но данные тега невозможно восстановить в виде встроенного тега, поскольку он изначально не был распознан как таковой.

Чтобы пользовательский или нестандартный тег сохранялся внутри одного сегмента как защищённый встроенный тег, добавьте его имя в «Переводимые встроенные элементы» в настройках импорта файлов HTML для этого типа файлов. Этот параметр также можно настроить в шаблоне проекта, чтобы он автоматически применялся к проектам, созданным на основе этого шаблона.

Настройки для конкретного приложения

Drupal/Wordpress .XLIFF

Настройки применяются в шаблоне проекта, используемом с плагином Drupal.

Фильтр Wordpress использует подфильтр HTML, поэтому можно применить настройки импорта .HTML. Если требуется более тонкая настройка, чем позволяют параметры импорта HTML, следует использовать формат .XML.

Drupal/WordPress XLIFF также является хорошим вариантом по умолчанию для файлов .XLIFF, когда переводимые строки находятся в CDATA и содержат теги HTML.

memoQ

Настройки недоступны, если файл был автоматически определен и импортирован как memoQ XLIFF. Если требуется настройка, импортируйте файл, используя параметры импорта XLIFF 1.2. Статусы сегментов memoQ XLIFF должны быть настроены вручную в параметрах импорта.

HTML-подфильтр и пользовательские встроенные теги

При использовании HTML-подфильтра, например с параметрами импорта XLIFF 2.0, в защищённые встроенные теги, остающиеся внутри одного сегмента, преобразуются только элементы из стандартного списка распознаваемых встроенных HTML-элементов, такие как span, a и em. Любое другое имя тега, используемого для обрамления текста, включая имена пользовательских или псевдотегов, таких как link, не распознаётся как встроенный элемент. HTML-подфильтр вместо этого рассматривает нераспознанный тег как границу сегмента, поэтому маркеры тегов не появляются внутри какого-либо отдельного сегмента в редакторе. Окружающий текст и содержимое внутри тега сохраняются в исходных данных сегментов, но разметка тега разделяется между соседними сегментами, а не сохраняется в виде одного защищённого тега.

Чтобы сохранить пользовательский или псевдотег в качестве защищенного встроенного тега внутри одного сегмента, добавьте имя этого тега в поле «Переводимые встроенные элементы» в настройках импорта HTML-файлов для данного типа файлов. Этот параметр также можно настроить как часть шаблона проекта или на уровне организации в разделе «Параметры импорта файлов», чтобы он применялся по умолчанию к новым проектам, использующим те же параметры импорта.