Markdown dosyaları¶

Added in version 5.0.

Not

Bu biçimin desteği şu anda geliştirme aşamasında. Bazı özellikler henüz kullanılamıyor olabilir ve davranışları sürümler arasında değişiklik gösterebilir. Denemelerinizle ilgili geri bildirimlerinizi bekliyoruz.

The translatable content is extracted from the Markdown files and offered for the translation. For Markdown files with JSX syntax, use MDX files.

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.

Not

Diğer biçimlerin çoğunun aksine, çeviri dosyalarındaki değişiklikler güvenilir bir şekilde yapılamadığından Weblate üzerine aktarılmayacak. Çevirilerin doğruluğunun kaynağı çevrilmiş dosya değil Weblate olur.

Ayrıca bakınız

Markdown

Örnek dosya:

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Desteklenen özellikler¶
Dosya uzantıları	`.md`
Dilsellik i	Tek dilli
Çoğulları destekler ⓘ	`No`
Tanımlamaları destekler ⓘ	`No`
Açıklamayı destekler ⓘ	`No`
Bağlamı destekler ⓘ	`No`
Konumu destekler ⓘ	`No`
İmleri destekler ⓘ	`No`
API belirteci	`markdown`
Salt okunur dizgeleri destekler ⓘ	`No`
Check flags added by this format ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate yapılandırması¶

Tipik Weblate Bileşen yapılandırması
Dosya maskesi	`path/*.md`
Tek dilli temel dil dosyası	`path/en.md`
Yeni çeviriler kalıbı	`path/en.md`
Dosya biçimi	Markdown dosyası
Dosya biçimi parametreleri	`markdown_merge_duplicates=True`

Yinelenen dizgelerin işlenmesi¶

Varsayılan olarak, Weblate, satır temelli bağlam sağlamak için bir dizgenin her oluşumunu ayrı bir çeviri birimi olarak ele alır. Bu durum, satırları yeniden sıralamanın bağlamı değiştirdiği ve çeviri kaybına yol açabileceği Markdown tablolarında sorunlu olabilir.

Özdeş dizgeleri tek bir çeviri biriminde birleştirmek için Dosya biçimi parametreleri dosyasında Yinelenen dizgeler birleştirilsin` seçeneğini açın.

Not

Bu seçeneği açmak, birleştirilmiş birimler için satır temelli bağlamı kapatarak, satırların veya bölümlerin belge içinde konumu değişse bile çevirilerin sabit kalmasını sağlar.

Translating front matter values¶

By default, YAML front matter is extracted as a single translatable block. Enable Translate front matter values in Dosya biçimi parametreleri 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 files.