Файлы Markdown¶

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

Примечание

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

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

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

Примечание

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

См. также

Markdown

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

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Поддерживаемые функции¶
Расширения файлов	`.markdown`, `.md`
Языковость ⓘ	Одноязычный
Поддерживает множественное число ⓘ	`No`
Поддерживает описания ⓘ	`No`
Поддерживает пояснения ⓘ	`No`
Поддерживает контекст ⓘ	`No`
Поддерживает расположение ⓘ	`No`
Поддерживает флаги ⓘ	`No`
Идентификатор API	`markdown`
Поддерживает строки только для чтения ⓘ	`No`
Поддерживает удаление устаревших строк ⓘ	`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, где переупорядочивание строк изменяет контекст и может привести к потере перевода.

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

Примечание

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

Перевод значений front matter¶

По умолчанию YAML front matter извлекается как единый переводимый блок. Включите Переводить значения front matter в Параметры формата файла, чтобы анализировать YAML front matter и переводить только скалярные строковые значения, сохраняя ключи, структуру, комментарии и форматирование, когда это возможно. Та же настройка доступна для файлов Файлы MDX.