Формат файла .XML не предназначен для перевода и требует дополнительных настроек для успешного импорта.
Настройки по умолчанию отмечены звездочкой (*). При их использовании все элементы XML импортируются для перевода. Параметры импорта можно использовать для изменения поведения при импорте.
Сервисы ИИ могут эффективно выявлять ошибки формата в файлах на основе .XML.
Типы файлов
-
.XML
Параметры импорта
Обычные правила импорта
-
Импортируются только выбранные элементы (т. е. name, title, para). Звездочка () импортирует все элементы.
-
Импортируются только выбранные атрибуты (т. е. name, title, para). Звездочка () импортирует все атрибуты.
-
Если выбран параметр «», все элементы в переводимом тексте импортируются как Переводимые встроенные элементы.
-
Выбранный встроенный элемент name, title, para будет преобразован в теги, и его содержимое не будет доступно для перевода.
Важно
Проблемы с тегами являются распространенной причиной ошибок при экспорте (например, ), особенно для таких типов файлов, как электронные таблицы (на основе MS Excel) и .XML. Всегда проверяйте правильность тегов и форматирования перед экспортом файлов, выполняя проверки контроля качества.
-
Элементы, соседствующие с текстовыми узлами, будут автоматически преобразованы во встроенные теги.
-
Код выбранного элемента обрабатывается как .HTML. Для этих элементов можно использовать параметры импорта .HTML, такие как Сохранять пробелы или Тег переноса строки (<br/>) создает новый сегмент.
Используйте этот параметр, если значение выбранного элемента содержит разметку .HTML. Он не применяется к дочерним элементам выбранного элемента, если не указано иное.
-
Выбранные элементы будут импортированы как Заблокированные.
-
Выбранные атрибуты будут импортированы как Заблокированные.
-
Введите в выходной файл список ссылок на символы, разделённых запятыми.
Например:
-
Применить регулярные выражения, чтобы преобразовать указанный текст в теги.
-
Сообщения ICU автоматически конвертируются в теги. Если сегмент содержит встроенные элементы, синтаксический анализ ICU для этого сегмента пропускается. Сегменты без встроенных элементов анализируются обычным образом.
-
XML-сущности в объявлении DTD будут импортированы для перевода.
-
-
Комментарии не импортируются, если элементы обрабатываются как HTML, как указано в параметре Элементы (обрабатывать как HTML).
-
Выберите этот параметр, чтобы предотвратить сегментацию внутри парных тегов XML или подэлементов. Это полезно, если XML содержит вложенные структуры, где сегментация нарушила бы логический смысл текста.
-
Можно загрузить таблицу стилей .XSL и создать на её основе удобный для чтения файл предварительного просмотра.
Настройки XML с использованием XPath
Использование языка запросов XPath позволяет создавать сложные правила импорта и пользоваться некоторыми дополнительными возможностями, недоступными при использовании обычных правил импорта.
Выражение XPath должно указывать на элементы и/или атрибуты, текст или значение которых требуется перевести, а не на сами текстовые узлы.
Перед использованием рекомендуется ознакомиться с XPath.
Параметры «», «» и «» не обрабатываются для файлов, содержащих более 10 000 XML-элементов.
-
Составляет контекст памяти переводов (TM) (101% совпадения), если это применимо.
Если выражение XPath для параметра «» не указано, фильтр XML по умолчанию не создает ключ контекста. Чтобы создать ключ контекста на основе структурного пути сегмента, установите для параметра «» значение «Ключ сегмента» в настройках импорта «».
-
Импортируйте элементы или атрибуты контекста для каждого элемента.
-
Импортировать элементы или максимальную длину перевода для каждого элемента. Ограничение количества символов для каждого сегмента отображается на панели в редакторе. Любой символ, превышающий лимит, выделен красным цветом.
-
Оставьте пустым, чтобы сохранить пробельные символы в элементах. Примените xml:whitespace='preserve'. //*, чтобы сохранить все пробельные символы во всех элементах, или используйте произвольное выражение XPath.
-
Укажите XML-элементы или атрибуты, которые не следует сегментировать. Введите XPath-выражение, которое определяет узлы, подлежащие исключению. Любой текст, извлеченный из этих узлов, будет сохранен как единый сегмент, а не разделен на более мелкие единицы.
Введите //element[@attr='value'], чтобы исключить из сегментации все узлы
<element>, содержащие атрибутattr="value".
Предварительный просмотр HTML с таблицей стилей XSLT
Язык XSLT (Extensible Stylesheet Language Transformations) можно использовать для преобразования документов .XML в формат .HTML для контекстного предварительного просмотра. Соответственно, файлы предварительного просмотра, загруженные с помощью команды «Предварительный просмотр перевода» в меню Документ, имеют расширение HTML. В настоящее время Phrase поддерживает XSLT 2.0.
XSLT для предварительного просмотра должен основываться на переводе, а не на исходном тексте.
Нажмите «Выберите файл», чтобы импортировать таблицу стилей.
После импорта файла нажмите «Скачать XSLT», чтобы загрузить таблицу стилей.
CDATA в XML-файле
CDATA означает символьные данные (Character Data) и определяется как блоки текста, которые не обрабатываются парсером, но распознаются как разметка. Предопределенные сущности, такие как <, > и &, требуют ввода и, как правило, трудночитаемы в разметке. В таких случаях можно использовать раздел CDATA.
Если CDATA содержит встроенный .HTML, соответствующие XML-элементы необходимо перечислить в разделе «».
Если исходный файл содержит CDATA и включен параметр «», CDATA добавляется к каждому сегменту в готовом файле.
CDATA будет сегментироваться только при наличии четкого указания на разрыв сегмента, например, знака препинания или пробела.
Источник:
<text><![CDATA[Translatable text A. Translatable text B.]]></text>
Целевой текст:
<text><![CDATA[Translatable text A.]]><![CDATA[ ]]><![CDATA[Translatable text B.]]></text>
Готовый файл соответствует формату .XML, а средство просмотра XML корректно отобразит текст как Translatable text A. Translatable text B.
Многоязычные файлы импортируются как несколько двуязычных заданий с языками, сопоставленными перед импортом. В таблице «Задания» они обозначены значком . Если файл импортирован для нескольких целевых языков, готовый файл содержит переводы на все целевые языки.
Phrase поддерживает XML-файлы, в которых присутствуют как исходные, так и целевые элементы для всех абзацев, даже если целевой элемент пуст. Если сегментация исходного и целевого текста различается, определяющей является сегментация исходного текста.
Все отдельные языковые элементы должны быть потомками одного и того же элемента trans-unit, и один языковой элемент не может содержаться внутри другого. Исходное и целевое содержимое не может храниться в значениях атрибутов. Если внутри элемента trans-unit несколько элементов соответствуют XPath для исходного или целевого текста, для перевода импортируется только первый из них.
-
При создании задания выберите «» на панели «», прежде чем применять параметры импорта. Если не выбрать этот тип файла, файл будет импортирован как обычный .XML.
-
Содержимое тегов исходного файла .XML можно просмотреть в редакторе, выбрав «Развернуть теги» в меню «», и отредактировать, нажав F2.
Например:
Образец частично переведенного текста с английского на немецкий и французский языки. Все <tuv lang="en">, <tuv lang="de"> и <tuv lang="fr"> являются дочерними элементами одного и того же элемента <tu>.
<?xml version="1.0" encoding="utf-8"?>
<root>
Not translatable text.
<tu note="context note" key="ID 254" maxlen="16">
<tuv lang="en">
<seg>First segment.</seg>
</tuv>
<tuv lang="de">
<seg>Erste segment</seg>
</tuv>
<tuv lang="fr">
<seg></seg>
</tuv>
</tu>
<tu note="another context note" key="ID 255" maxlen="18">
<tuv lang="en">
<seg>Second segment.</seg>
</tuv>
<tuv lang="de">
<seg></seg>
</tuv>
<tuv lang="fr">
<seg></seg>
</tuv>
</tu>
</root>
Параметры импорта
Для импорта многоязычных файлов .XML необходимо использовать язык запросов XPath. См. пример выше для справки. Выражение XPath определяет элементы, в которых должен быть переведен текст/значение, а не сам текстовый узел.
-
//tu -
tuv[@lang='en']/seg(по отношению к родительскому элементу//tu) -
Все элементы в исходном или целевом тексте считаются переводимыми встроенными элементами, если здесь они не указаны как непереводимые встроенные элементы.
-
Укажите ключ контекста, который сохраняется вместе с сегментом в памяти переводов и используется при поиске совпадений с учетом контекста.
-
Импортируйте элементы или атрибуты контекста для каждого элемента.
-
Импортируйте элементы или максимальную длину перевода для каждого элемента
-
Введите список ссылок на символы (разделенных запятыми) в выходной файл.
Например:
-
Применить регулярные выражения, чтобы преобразовать указанный текст в теги.
-
Сообщения ICU автоматически конвертируются в теги. Если сегмент содержит встроенные элементы, синтаксический анализ ICU для этого сегмента пропускается. Сегменты без встроенных элементов анализируются обычным образом.
-
Импортируются HTML теги, содержащиеся в файле. Далее теги можно использовать с настройками импорта файлов HTML. Теги абзацев
<p>создают новые сегменты, даже если параметр «» не выбран. -
Импортируются HTML теги, содержащиеся в файле. Далее теги можно использовать с настройками импорта файлов HTML.
-
Текст сегментируется по общему правилу сегментации, а не по одному сегменту на ячейку.
Осторожно
Применение параметра «» к файлу с целевым текстом может привести к тому, что количество сегментов в исходном и целевом текстах будет различаться.
-
Выберите статус подтверждения по умолчанию и укажите, следует ли автоматически добавлять подтвержденные сегменты в память переводов.
-
Можно загрузить таблицу стилей .XSL и создать на ее основе удобный для чтения файл предварительного просмотра.
Пример: