Súbory MDX

Added in version 2026.5.

Poznámka

Podpora tohto formátu je vo vývoji. Niektoré funkcie nemusia byť ešte dostupné a správanie sa môže medzi vydaniami meniť. Spätná väzba z testovania je vítaná.

Súbory MDX sú súbory Markdown so syntaxou JSX. Weblate extrahuje preložiteľný text Markdown a zachováva importy, exporty, komponenty JSX a výrazy.

Jednotky MDX automaticky dostanú príznaky md-text, auto-safe-html, strict-same a safe-mdx. 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 MDX a podobnej 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

MDX

Príklad súboru:

---
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.*

Podporované funkcie

Prípony súborov	.mdx
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	mdx
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, Bezpečný MDX

Konfigurácia Weblate

Typický Weblate Konfigurácia komponentu
Maska súboru	path/*.mdx
Jednojazyčný súbor základného jazyka	path/en.mdx
Šablóna pre nové preklady	path/en.mdx
Formát súboru	Súbor MDX
Parametre formátu súboru	mdx_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 MDX alebo pri opakovanom obsahu komponentov, kde zmena poradia 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ú.