Файлы Markdown¶

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

Примечание

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

Переводимое содержимое извлекается из файлов Markdown и предлагается для перевода. Для файлов Markdown с синтаксисом JSX используйте Файлы MDX.

Markdown units automatically get the md-text, auto-safe-html and strict-same flags. This keeps the unsafe HTML check active for plain text, standard HTML, and custom elements while avoiding HTML cleanup on non-HTML angle-bracket syntax such as MDX or JSX-like components. Use the explicit safe-html flag for strings that are known to contain HTML and should always be sanitized, including SVG or MathML snippets.

Примечание

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

См. также

Markdown

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

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

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

Настройка Weblate¶

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

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

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

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

Примечание

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

Translating front matter values¶

By default, YAML front matter is extracted as a single translatable block. Enable Translate front matter values in Параметры формата файла to parse YAML front matter and translate only scalar string values while preserving keys, structure, comments, and formatting when possible. The same setting is available for Файлы MDX files.