Файлы MDX¶

Добавлено в версии 2026.5.

Примечание

Поддержка этого формата находится в стадии разработки. Некоторые функции могут быть ещё недоступны, и поведение может меняться в зависимости от выпуска. Отзывы о тестировании приветствуются.

Файлы MDX — это файлы Markdown с синтаксисом JSX. Weblate извлекает переводимый текст Markdown и сохраняет импорты, экспорты, компоненты JSX и выражения.

Единицы MDX автоматически получают флаги md-text и auto-safe-html. Это сохраняет проверку небезопасного HTML активной для обычного текста, стандартного HTML и пользовательских элементов, избегая очистки HTML для синтаксиса MDX и подобного JSX. Используйте явный флаг safe-html для строк, которые, как известно, содержат HTML и всегда должны быть очищены, включая фрагменты SVG или MathML.

Примечание

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

См. также

MDX

Пример файла:

---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

Поддерживаемые функции¶
Расширения файлов	`.mdx`
Языковость ⓘ	Одноязычный
Поддерживает множественное число ⓘ	`No`
Поддерживает описания ⓘ	`No`
Поддерживает пояснения ⓘ	`No`
Поддерживает контекст ⓘ	`No`
Поддерживает расположение ⓘ	`No`
Поддерживает флаги ⓘ	`No`
Идентификатор API	`mdx`
Поддерживает строки только для чтения ⓘ	`No`
Check flags added by this format ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Настройка Weblate¶

Типичный Настройки компонента Weblate
Маска файла	`path/*.mdx`
Одноязычный базовый файл	`path/en.mdx`
Шаблон для новых переводов	`path/en.mdx`
Формат файла	Файл MDX
Параметры формата файла	`mdx_merge_duplicates=True`

Обработка дублирующихся строк¶

По умолчанию Weblate обрабатывает каждое вхождение строки как отдельную единицу перевода для обеспечения построчного контекста. Это может быть проблематично в таблицах MDX или повторяющемся содержимом компонентов, где переупорядочивание изменяет контекст и может привести к потере перевода.

Чтобы объединить идентичные строки в одну единицу перевода, включите Дедупликация идентичных строк в Параметры формата файла.

Примечание

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