Súbory Markdown¶

Added in version 5.0.

Preložiteľný obsah sa extrahuje zo súborov Markdown a ponúka sa na preklad. Pre súbory Markdown so syntaxou JSX použite Súbory MDX.

Jednotky Markdown automaticky dostanú príznaky md-text, auto-safe-html a strict-same. Tým sa udržuje kontrola nebezpečného HTML aktívna pre obyčajný text, štandardné HTML a vlastné prvky, pričom sa vyhnete čisteniu HTML pri syntaxi s lomenými zátvorkami, ktorá nie je HTML, ako sú komponenty podobné MDX alebo JSX. Použite explicitný príznak safe-html pre reťazce, o ktorých viete, že obsahujú HTML a mali by byť vždy sanitizované, vrátane úryvkov SVG alebo MathML.

Poznámka

Na rozdiel od väčšiny iných formátov sa zmeny v súboroch prekladu neimportujú do Weblate, pretože to nie je možné urobiť spoľahlivo. Zdrojom pravdy pre preklady je Weblate, nie preložený súbor.

Viď aj

Markdown

Príklad súboru:

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Podporované funkcie¶
Prípony súborov	`.markdown`, `.md`
Jazykovosť ⓘ	Jednojazyčné
Podporuje množné číslo ⓘ	`No`
Podporuje popisy ⓘ	`No`
Podporuje vysvetlenie ⓘ	`No`
Podporuje kontext ⓘ	`No`
Podporuje umiestnenie ⓘ	`No`
Podporuje príznaky ⓘ	`No`
Identifikátor API	`markdown`
Podporuje reťazce iba na čítanie ⓘ	`No`
Podporuje odstraňovanie zastaraných reťazcov ⓘ	`No`
Skontrolovať príznaky pridané týmto formátom ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Konfigurácia Weblate¶

Typický Weblate Konfigurácia komponentu
Maska súboru	`path/*.md`
Jednojazyčný súbor základného jazyka	`path/en.md`
Šablóna pre nové preklady	`path/en.md`
Formát súboru	Súbor Markdown
Parametre formátu súboru	`markdown_merge_duplicates=True`

Spracovanie duplicitných reťazcov¶

Predvolene Weblate považuje každý výskyt reťazca za samostatnú prekladovú jednotku, aby poskytol kontext založený na riadkoch. To môže byť problematické v tabuľkách Markdown, kde zmena poradia riadkov mení kontext a môže viesť k strate prekladu.

Aby ste konsolidovali identické reťazce do jednej prekladovej jednotky, povoľte Odstrániť duplicity identických reťazcov v Parametre formátu súboru.

Poznámka

Povolenie tejto možnosti vypne kontext založený na riadkoch pre zlúčené jednotky, čo zabezpečí, že preklady zostanú stabilné, aj keď sa riadky alebo sekcie v dokumente presunú.

Preklad hodnôt front matter¶

Predvolene sa YAML front matter extrahuje ako jeden preložiteľný blok. Povoľte Preložiť hodnoty front matter v Parametre formátu súboru na spracovanie YAML front matter a preklad iba skalárnych hodnôt reťazcov pri zachovaní kľúčov, štruktúry, komentárov a formátovania, ak je to možné. Rovnaké nastavenie je dostupné pre súbory Súbory MDX.