MDX
Překládejte text v MDX a vybrané vlastnosti komponent zadané jako literály. Výrazy, importy i struktura komponent zůstanou zachovány.
MDX umožňuje v článku kombinovat běžný text s interaktivními komponentami. Modul pro zpracování souborů mdx překládá podporovaný text i vnořený obsah komponent a zachovává přitom jejich značky. Pokud vlastnosti komponent zadané jako literály obsahují také text určený čtenářům, vyberte je k překladu výslovně. Importy ani výrazy se při vyhledávání textu nespouštějí.
Oddělte text od dat komponent #
Například komponenta upozornění má viditelný nadpis i vlastnost, která řídí její chování:
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>Nadpis a vnořený text jsou určeny k překladu. kind představuje data komponenty, která mají zůstat beze změny. title se do překladu zahrne jen tehdy, když tuto vlastnost vybere pravidlo pro vlastnosti komponent. Pravidlo omezené na Callout a title je bezpečnější než překládat všechny atributy s tímto názvem i u nesouvisejících komponent.
Podporovány jsou vlastnosti zadané jako řetězcové literály. Vlastnost vypočítaná výrazem není totéž co text zadaný jako literál. Importy, výrazy JavaScriptu ani bloky kódu se při běžné extrakci textu nezpracovávají. Struktura komponent musí i nadále odpovídat vykreslovacímu systému aplikace.
Frontmatter a kotvy nadpisů #
Modul pro zpracování souborů ve výchozím nastavení vybírá z metadat frontmatter položky title a description. Pokud chcete metadata frontmatter ponechat bez překladu, zadejte prázdný výběr. Výběrem mapy nebo sekvence zahrnete i její podřízené skalární hodnoty. Pokud tedy sousední pole pro směrování musí zůstat beze změny, zadávejte přesné cesty, například seo.title. Podrobnosti o translateFrontmatterFields a translateComponentProps najdete v části Konfigurace CLI.
Kotvy nadpisů v Docusaurus, například {#delivery}, zůstávají chráněné, i když se text nadpisu mění. Zpracování kotev rozpoznává syntaxi na řádcích nadpisů mimo ohraničené bloky kódu a ponechává slugy URL beze změny. Na svém webu ověřte ID vykresleného nadpisu i odkazy, které na něj vedou.
Aktualizace a párování textu #
Stávající znění lze převzít, pokud si v předchozím zdrojovém a cílovém dokumentu odpovídají textové jednotky i chráněná struktura vložených prvků. Pokud tato shoda není jednoznačná, modul může opětovné použití odmítnout. Schválené cílové dokumenty uchovávejte spolu s odpovídající revizí zdroje. Nepředkládejte místo nich bez upozornění dokument se strukturou, která zdroji neodpovídá.
Po rekonstrukci dokumentu zkontrolujte vybrané vlastnosti včetně viditelných popisků mimo vnořený text a výsledek sestavte pomocí procesoru MDX své aplikace.
Nastavte překlad MDX #
CLI odvodí mdx z .mdx. Omezení rozsahu na klíče není pro tento formát dostupné. Možnosti nastavení souborů najdete v části Konfigurace CLI nebo GitHub.
Zkontrolujte vykreslenou komponentu #
Sestavte získaný soubor MDX pomocí procesoru, který skutečně používáte, a společně zkontrolujte vlastnosti komponent, kotvy, proměnné i ukázky kódu. Překlad souborů MDX zachovává dokument obsahující JSX. Extrakce textů z Reactu naproti tomu vyhledává podporovaná volání ve zdrojovém kódu aplikace a vytváří katalogy. Zvolte workflow podle toho, kde text vzniká.