MDX
Übersetze MDX-Fließtext und ausgewählte, als Literale angegebene Komponenteneigenschaften, ohne Ausdrücke, Importe oder die Komponentenstruktur zu verändern.
Mit MDX lassen sich interaktive Komponenten direkt in den Fließtext eines Artikels einbinden. Der Dateihandler für mdx übersetzt unterstützten Fließtext und untergeordnete Komponenteninhalte. Ihr Markup bleibt dabei erhalten. Wähle als Literale angegebene Komponenteneigenschaften gezielt aus, wenn sie ebenfalls sichtbaren Text enthalten. Importe und Ausdrücke werden nicht ausgeführt, um Text zu ermitteln.
Fließtext von Komponentendaten trennen #
Ein Hinweisfeld hat beispielsweise sowohl einen sichtbaren Titel als auch eine Eigenschaft, die sein Verhalten steuert:
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>Die Überschrift und der untergeordnete Fließtext werden übersetzt. kind gehört zu den Komponentendaten und sollte unverändert bleiben. title wird nur dann übersetzt, wenn eine Regel für Komponenteneigenschaften es auswählt. Eine auf Callout und title beschränkte Regel ist sicherer, als jedes gleichnamige Attribut über verschiedene, nicht zusammengehörige Komponenten hinweg zu übersetzen.
Eigenschaften mit String-Literalen werden unterstützt. Eine Eigenschaft, deren Wert durch einen Ausdruck berechnet wird, ist nicht mit einem als Literal angegebenen Text gleichzusetzen. Importe, JavaScript-Ausdrücke und Codeblöcke sind von der regulären Fließtextextraktion ausgenommen. Die Komponentenstruktur muss weiterhin zum Renderer der Anwendung passen.
Frontmatter und Überschriftenanker #
Der Dateihandler wählt standardmäßig die Frontmatter-Felder title und description aus. Gib eine leere Auswahl an, um das Frontmatter unübersetzt zu lassen. Wenn du eine Map oder Sequenz auswählst, werden auch alle darin enthaltenen skalaren Werte einbezogen. Wähle daher gezielte Pfade wie seo.title, wenn benachbarte Routing-Felder unverändert bleiben müssen. Informationen zu translateFrontmatterFields und translateComponentProps findest du unter CLI-Konfiguration.
Docusaurus-Überschriftenanker wie {#delivery} bleiben geschützt, während der Überschriftentext übersetzt wird. Die Ankerverarbeitung erkennt die Syntax in Überschriftenzeilen außerhalb von Codeblöcken mit Begrenzungszeichen und lässt URL-Slugs unverändert. Vergewissere dich, dass die gerenderte Überschriften-ID und die darauf verweisenden Links auf deiner Website korrekt sind.
Aktualisierungen und Zuordnung #
Vorhandene Formulierungen lassen sich übernehmen, wenn die bisherigen Quell- und Zieltexte einander entsprechende Texteinheiten und geschützte Inline-Strukturen aufweisen. Ist diese Zuordnung nicht eindeutig, kann der Handler die Wiederverwendung ablehnen. Halte akzeptierte Zieltexte mit der jeweiligen Version des Quelltexts verknüpft, statt stillschweigend ein strukturell nicht dazu passendes Dokument bereitzustellen.
Sieh dir nach der Rekonstruktion die ausgewählten Eigenschaften an, einschließlich sichtbarer Beschriftungen außerhalb des untergeordneten Fließtexts, und führe den Build mit dem MDX-Prozessor deiner Anwendung aus.
MDX-Übersetzung konfigurieren #
Die CLI leitet mdx aus .mdx ab. Eine Eingrenzung auf bestimmte Schlüssel ist für dieses Format nicht verfügbar. Dateioptionen findest du unter CLI-Konfiguration oder GitHub.
Gerenderte Komponente kontrollieren #
Führe den Build der abgerufenen MDX-Datei mit dem tatsächlich eingesetzten Prozessor aus und sieh dir Komponenteneigenschaften, Anker, Variablen und Codebeispiele im Zusammenspiel an. Bei der Übersetzung von MDX-Dateien bleibt das Dokument mit seinem JSX erhalten. Die React-Textextraktion findet dagegen unterstützte Aufrufe im Quellcode der Anwendung und erstellt daraus Kataloge. Wähle den Workflow danach aus, wo der Text verfasst wird.