Типы файлов
-
.MD
-
.MARKDOWN
-
.MDX
Параметры импорта
-
Выберите диалект Markdown, который парсер будет использовать при импорте файла. Это также влияет на то, какие символы автоматически экранируются/деэкранируются при импорте и экспорте.
-
Анализирует только базовую структуру Markdown (заголовки, абзацы, списки, базовое выделение).
-
Анализирует с использованием диалекта PHP Markdown Extra / Python-Markdown «Extra», добавляя поддержку таблиц, списков определений, сносок, сокращений и списков атрибутов.
-
Анализирует с использованием спецификации GitHub Flavored Markdown (GFM), добавляя поддержку таблиц, списков задач, зачеркивания и автоссылок.
-
Анализирует файл как MDX: Markdown плюс компоненты JSX, выражения JSX (
{...}) и операторы ESMimport/export. Таблицы, списки задач, зачеркивание и автоссылки работают так же, как в GitHub Flavored Markdown. Блоки кода с отступом и автоссылки в угловых скобках (<url>) не поддерживаются, так как MDX использует отступы для вложенности компонентов и не анализирует эти конструкции.MDX — это Markdown с расширением JSX, поэтому контент может содержать встроенные компоненты и выражения JavaScript (например, в документации, созданной с помощью Docusaurus или Next.js). Фильтр MDX никогда не выбирается автоматически: его необходимо выбирать в настройках импорта файлов как для файлов .MDX, так и для файлов .MD, содержащих синтаксис MDX. Автоматическое определение по расширению файла или содержимому отсутствует.
Примечание
Поддержка MDX должна быть включена для вашей организации. Если MDX отсутствует в списке , обратитесь к своему менеджеру по работе с клиентами или в службу поддержки Phrase.
Важно
Переключение существующего проекта с другого фильтра Markdown на MDX изменяет способ сегментации контента. После переключения ожидайте разового снижения доли совпадений с памятью переводов.
-
-
Начинает новый сегмент при каждом принудительном переносе строки.
-
Сохраняет в целевом документе ту же структуру пробельных символов (например, пробелы, переносы строк и т. д.).
-
Обрабатывает YAML-заголовок в начале файла. При выборе применяются настройки импорта .YAML.
-
Извлекает содержимое блоков кода для перевода. При использовании фильтра MDX это также относится к блокам кода, выделенным ограждающими маркерами и вложенным в компоненты JSX (например, внутри
<CodeGroup>). -
При выборе этой опции элементы кода импортируются как отдельные теги системы Phrase TMS.
-
Делает URL-адреса доступными для перевода.
-
Применить регулярные выражения, чтобы преобразовать указанный текст в теги.
Важно
Проблемы с тегами являются распространенной причиной ошибок экспорта. Всегда проверяйте правильность тегов и форматирования перед экспортом файлов, выполняя проверки контроля качества.
-
Определите элементы в файле, которые должны быть преобразованы в теги.
-
Определите разделы в файле, которые не следует импортировать.
Например:
Имя элемента:
notrans.Код:
<notrans>Chrysler</notrans> entered three factory-prepared <notrans>Dodge Shadows</notrans> to the event in 1985. All three vehicles retired in the first day of the three-day <notrans>Olympus</notrans> rally.Результат: Chrysler は、1985年に工場で準備された3台の Dodge Shadows に参加しました。3台の車両はすべて3日間の Olympus ラリーの初日にリタイアしました。
-
Список символов, которые не должны экранироваться в готовом файле (например,
#,-,[,<,\,`,.При использовании фильтра MDX символы
<и{по умолчанию экранируются в переведенном тексте, поскольку неэкранированный символ<или{в целевом тексте нарушил бы синтаксис MDX. Добавляйте их сюда только в том случае, если в выходном файле требуется именно неэкранированный символ.
Параметры MDX
Следующие четыре параметра доступны только тогда, когда в разделе выбран MDX.
-
Определите дополнительные пары тегов и атрибутов JSX, чтобы сделать их переводимыми, используя тот же формат
tag/attribute, что и в настройке фильтра HTML. Например,Figure/titleпозволяет переводить атрибутtitleтолько у компонентаFigure, аtitleбез указания тега — у всех тегов.Пользовательские компоненты (имена тегов, начинающиеся с заглавной буквы, например
<Figure>) по умолчанию не имеют переводимых атрибутов, поэтому перечислите их здесь явно. Для тегов в нижнем регистре или в стиле HTML (<img>,<a>и т. д.) уже определены стандартные атрибуты, переводимые по умолчанию. -
Включено по умолчанию.
Применяет к тегам в нижнем регистре или в стиле HTML стандартный набор переводимых атрибутов (например,
altу<img>,titleу<a>) в дополнение к атрибутам, указанным в настройке . Эти стандартные настройки не применяются к пользовательским компонентам независимо от значения данного параметра. Их атрибуты можно переводить только в том случае, если они добавлены в настройку .Если этот параметр отключён, переводятся только атрибуты, перечисленные в настройке , даже у тегов в нижнем регистре.
-
Включено по умолчанию.
Определяет, переводится ли по умолчанию текст внутри компонента JSX.
-
Если включено: Текст внутри любого компонента (например,
<Tabs>,<Note>) переводится, если компонент не указан в настройке . -
Если отключено: Текст внутри компонентов не переводится, если компонент не указан в настройке .
-
-
Список имён компонентов через запятую, для которых применяется значение, противоположное значению настройки .
Для компонента, указанного здесь, правило меняется целиком: на всё его содержимое, включая вложенные компоненты, распространяется переопределение, и вложенные компоненты не рассматриваются по отдельности. Когда переопределение делает компонент непереводимым, его содержимое сохраняется в точности в том виде, в котором оно было написано. Используйте этот список, чтобы:
-
исключить несколько компонентов, не содержащих связного текста (например,
CodeGroup,Mermaid), если включена настройка , или -
разрешить несколько компонентов, содержащих связный текст, когда эта настройка отключена.
-
Как обрабатывается содержимое JSX
Это относится к случаю, когда в настройке выбран MDX.
-
Теги JSX (
<Component>,<Component attr="value" />), а также имена тегов и атрибутов никогда не переводятся. Переводятся только содержимое элементов и явно настроенные значения атрибутов. -
Выражения в фигурных скобках (
{...}), выражения JavaScript, атрибуты с оператором расширения ({...props}) и комментарии ({/* comment */}) никогда не переводятся. Они сохраняются в точности в том виде, в котором написаны, где бы они ни появлялись: в атрибутах, внутри текста или на отдельной строке. -
Операторы
importиexportвсегда исключаются из перевода, где бы они ни находились в файле.