MDX-bestanden¶

Added in version 2026.5.

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.

MDX-bestanden zijn bestanden van Markdown met syntaxis van JSX. Weblate neemt de vertaalbare tekst van Markdown uit en behoudt importeren, exporteren, componenten van JSX en expressies.

Eenheden van MDX 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 syntaxis als MDX of JSX 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

MDX

Voorbeeld bestand:

---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Ondersteunde mogelijkheden¶
Bestandsextensies	`.mdx`
Taalgebied ⓘ	Enkeltalig
Ondersteunt meervoud ⓘ	`No`
Ondersteunt beschrijvingen ⓘ	`No`
Ondersteunt uitleg ⓘ	`No`
Ondersteunt context ⓘ	`No`
Ondersteunt locatie ⓘ	`No`
Ondersteunt vlaggen ⓘ	`No`
API-identificatie	`mdx`
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/*.mdx`
Enkeltalig basistaalbestand	`path/en.mdx`
Sjabloon voor nieuwe vertalingen	`path/en.mdx`
Bestandsformaat	MDX-bestand
Parameters bestandsindeling	`mdx_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 MDX of herhaalde inhoud van het onderdeel, waar het opnieuw ordenen 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.