Markdown-bestanden¶

Added in version 5.0.

Notitie

Ondersteuning voor deze indeling is in ontwikkeling. Sommige mogelijkheden zouden nog niet beschikbaar kunnen zijn en het gedrag kan veranderen tussen uitgaven. Terugkoppeling vanuit testen is welkom.

De vertaalbare inhoud wordt uitgenomen uit de Markdown-bestanden en aangeboden voor vertalen. Voor Markdown-bestanden met syntaxis in JSX, gebruik MDX-bestanden.

Eenheden van Markdown krijgen automatisch de vlaggen md-text en auto-safe-html. Dat houdt de controle voor niet veilige HTMLactief voor platte tekst, standaard HTML en aangepaste elementen, terwijl opruimen van HTML in niet-HTML syntaxis tussen vierkante haken, zoals MDX of JSX-achtige componenten wordt vermeden. Gebruik de expliciete vlag safe-html voor tekenreeksen waarvan bekend is dat ze HTML bevatten en altijd zouden moeten worden schoongemaakt, inclusief SVG of snippers van MathML.

Notitie

Anders dan voor de meeste indelingen zullen de wijzigingen in de vertaalbestanden niet worden geïmporteerd in Weblate, omdat dat het niet betrouwbaar genoeg kan worden gedaan. De waarheid voor de bron van de vertalingen is Weblate, niet het vertaalde bestand.

Zie ook

Markdown

Voorbeeld bestand:

# Ahoj světe!

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Ondersteunde mogelijkheden¶
Bestandsextensies	`.md`
Taalgebied ⓘ	Enkeltalig
Ondersteunt meervoud ⓘ	`No`
Ondersteunt beschrijvingen ⓘ	`No`
Ondersteunt uitleg ⓘ	`No`
Ondersteunt context ⓘ	`No`
Ondersteunt locatie ⓘ	`No`
Ondersteunt vlaggen ⓘ	`No`
API-identificatie	`markdown`
Ondersteunt tekenreeksen alleen-lezen ⓘ	`No`
Check flags added by this format ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate-configuratie¶

Typisch Weblate Configuratie onderdeel
Bestandsmasker	`path/*.md`
Enkeltalig basistaalbestand	`path/en.md`
Sjabloon voor nieuwe vertalingen	`path/en.md`
Bestandsformaat	Markdown-bestand
Parameters bestandsindeling	`markdown_merge_duplicates=True`

Behandeling dubbele tekenreeksen¶

Standaard behandelt Weblate elk voorkomen van een tekenreeks als een zelfstandige vertaaleenheid om op regels gebaseerde context te verschaffen. Dat kan problematisch zijn in tabellen van Markdown, waar het opnieuw ordenen van rijen de context wijzigt en kan leiden tot verlies van vertalingen.

Consolideren van identieke tekenreeksen naar een enkele vertaaleenheid, schakel Identieke tekenreeksen ontvlechten in de Parameters bestandsindeling in.

Notitie

Inschakelen van deze optie schakelt op regels gebaseerd context voor de samengevoegde eenheden uit, wat ervoor zorgt dat vertalingen stabiel blijven, zelfs als rijen of gedeelten binnen het document worden verplaatst.