MDX
Переводите текст MDX и выбранные свойства компонентов, заданные строковыми литералами, сохраняя выражения, импорты и структуру компонентов.
MDX позволяет добавлять в статью интерактивные компоненты вместе с обычным текстом. Обработчик файлов mdx переводит поддерживаемый текст и дочернее содержимое компонентов, сохраняя разметку. Явно укажите свойства компонентов, заданные строковыми литералами, если они тоже содержат текст, который видят читатели. Импорты и выражения не выполняются для поиска текста.
Отделяйте текст от данных компонентов #
Например, у блока примечания есть видимый заголовок и свойство, которое управляет поведением:
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>Заголовок и дочерний текст переводятся. kind — данные компонента, которые должны оставаться неизменными. title попадает в перевод, только если это свойство выбрано правилом для свойств компонентов. Ограничить правило значениями Callout и title безопаснее, чем переводить все атрибуты с таким именем у не связанных между собой компонентов.
Поддерживаются свойства, заданные строковыми литералами. Свойство, значение которого вычисляется выражением, — не то же самое, что сообщение в виде строкового литерала. При обычном извлечении текста импорты, выражения JavaScript и блоки кода не обрабатываются. Структура компонентов по-прежнему должна соответствовать требованиям средства отрисовки приложения.
Метаданные frontmatter и якоря заголовков #
По умолчанию обработчик файлов выбирает поля title и description в метаданных frontmatter. Задайте пустой список выбора, чтобы оставить frontmatter без перевода. При выборе словаря или последовательности в перевод попадают и все вложенные скалярные значения. Поэтому указывайте точные пути, например seo.title, если соседние поля маршрутизации должны оставаться неизменными. Подробнее о translateFrontmatterFields и translateComponentProps см. в разделе Конфигурация CLI.
При переводе заголовков якоря Docusaurus, например {#delivery}, защищены от изменений. Обработчик распознаёт синтаксис якорей в строках заголовков вне блоков кода с ограждениями и оставляет слаги URL без изменений. Проверьте ИД заголовка после отрисовки и входящие ссылки на сайте.
Обновления и соответствие структуры #
Прежние формулировки можно использовать повторно, если в предыдущих версиях исходника и перевода друг другу соответствуют текстовые единицы и защищённая встроенная структура. Если соответствие неоднозначно, обработчик может отклонить повторное использование. Храните принятые переводы в паре с соответствующими версиями исходника, а не подставляйте без предупреждения документ с другой структурой.
После восстановления документа проверьте выбранные свойства, в том числе видимые подписи вне дочернего текста, и соберите результат с помощью MDX-процессора вашего приложения.
Настройте перевод MDX #
CLI определяет mdx по .mdx. Для этого формата область видимости ключей недоступна. Параметры файлов описаны в разделах Конфигурация CLI и GitHub.
Проверьте компонент после отрисовки #
Соберите полученный MDX с помощью процессора, который используется в вашем приложении, и проверьте всё вместе: свойства компонентов, якоря, переменные и примеры кода. При переводе файла MDX сохраняется документ с JSX. А извлечение сообщений React находит поддерживаемые вызовы в исходном коде приложения и создаёт каталоги. Выберите рабочий процесс в зависимости от того, где создаётся текст сообщения.