Настройки импорта файла

.MD / .MDX — Markdown и MDX (TMS)

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

Типы файлов

  • .MD

  • .MARKDOWN

  • .MDX

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

  • Фильтр 

    Выберите диалект Markdown, который парсер будет использовать при импорте файла. Это также влияет на то, какие символы автоматически экранируются/деэкранируются при импорте и экспорте.

    • Простой

      Анализирует только базовую структуру Markdown (заголовки, абзацы, списки, базовое выделение).

    • PHP/Python Markdown Extra

      Анализирует с использованием диалекта PHP Markdown Extra / Python-Markdown «Extra», добавляя поддержку таблиц, списков определений, сносок, сокращений и списков атрибутов.

    • GitHub Flavored Markdown

      Анализирует с использованием спецификации GitHub Flavored Markdown (GFM), добавляя поддержку таблиц, списков задач, зачеркивания и автоссылок.

    • MDX

      Анализирует файл как MDX: Markdown плюс компоненты JSX, выражения JSX ({...}) и операторы ESM import/export. Таблицы, списки задач, зачеркивание и автоссылки работают так же, как в GitHub Flavored Markdown. Блоки кода с отступом и автоссылки в угловых скобках (<url>) не поддерживаются, так как MDX использует отступы для вложенности компонентов и не анализирует эти конструкции.

      MDX — это Markdown с расширением JSX, поэтому контент может содержать встроенные компоненты и выражения JavaScript (например, в документации, созданной с помощью Docusaurus или Next.js). Фильтр MDX никогда не выбирается автоматически: его необходимо выбирать в настройках импорта файлов как для файлов .MDX, так и для файлов .MD, содержащих синтаксис MDX. Автоматическое определение по расширению файла или содержимому отсутствует.

      Примечание

      Поддержка MDX должна быть включена для вашей организации. Если MDX отсутствует в списке «Фильтр», обратитесь к своему менеджеру по работе с клиентами или в службу поддержки Phrase.

      Важно

      Переключение существующего проекта с другого фильтра Markdown на MDX изменяет способ сегментации контента. После переключения ожидайте разового снижения доли совпадений с памятью переводов.

  • Разрыв строки создает новый сегмент 

    Начинает новый сегмент при каждом принудительном переносе строки.

  • Не удалять пробелы 

    Сохраняет в целевом документе ту же структуру пробельных символов (например, пробелы, переносы строк и т. д.).

  • Обработка YAML заголовка 

    Обрабатывает YAML-заголовок в начале файла. При выборе применяются настройки импорта .YAML.

  • Импорт блоков кода 

    Извлекает содержимое блоков кода для перевода. При использовании фильтра MDX это также относится к блокам кода, выделенным ограждающими маркерами и вложенным в компоненты JSX (например, внутри <CodeGroup>).

  • Исключить элементы кода 

    При выборе этой опции элементы кода импортируются как отдельные теги системы Phrase TMS.

  • Сделать URL-адреса переводимыми

    Делает URL-адреса доступными для перевода.

  • Преобразовать в теги системы Phrase TMS 

    Применить регулярные выражения, чтобы преобразовать указанный текст в теги.

    Важно

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

  • Пользовательские элементы (преобразованные в теги Phrase) 

    Определите элементы в файле, которые должны быть преобразованы в теги.

  • Непереводимые блоки 

    Определите разделы в файле, которые не следует импортировать.

    Например:

    Имя элемента: 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 всегда исключаются из перевода, где бы они ни находились в файле.

Была ли эта статья полезной?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.