Markdown

Übersetze den Dokumenttext und ausgewählte Frontmatter-Felder und erhalte dabei Code, Links und die Struktur, die für die Wiederverwendung akzeptierter Formulierungen nötig ist.

Ein Markdown-Dokument verbindet erklärenden Text mit einer Struktur, die beim Lesen Orientierung bietet. Der Dateihandler md übersetzt Text in Überschriften, Absätzen, Tabellenzellen und unterstützten Direktivenbeschriftungen und schützt dabei Code und Linkziele. Das Ergebnis bleibt Markdown und lässt sich mit deinem bisherigen Renderer verwenden.

Text und geschützte Struktur #

So kann sich etwa der Linktext ändern, während das Linkziel und der Funktionsname unverändert bleiben:

markdown
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---

## Choose delivery

Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.

Überschrift, Absatztext und Linktext zählen zum übersetzbaren Text. Linkziel und Inline-Code gehören zur geschützten Struktur. Im Standardprofil für Dokumente werden durch Trennzeichen begrenzte Codeblöcke und unverarbeitetes HTML nicht als Text extrahiert. Verwende HTML, wenn die Quelle ein HTML-Dokument ist, oder Markdoc, wenn benutzerdefinierte Markdoc-Tags zur Dokumentsprache gehören.

Frontmatter-Felder auswählen #

Standardmäßig wählt der Dateihandler title und description aus. Andere Felder bleiben unverändert, sofern du sie nicht ausdrücklich auswählst. Eine leere translateFrontmatterFields-Liste deaktiviert die Frontmatter-Übersetzung. Welche Felder du auswählst, ist eine inhaltliche Entscheidung: Eine lesbare Überschrift lässt sich übersetzen, während ein Slug, eine Komponentenkennung oder ein Routing-Schlüssel möglicherweise unverändert bleiben muss.

Mit unterstützten Feldpfaden lassen sich auch verschachtelte Werte und Elemente von Sequenzen auswählen. Wenn du eine Zuordnung oder Sequenz auswählst, werden auch alle darin verschachtelten skalaren Werte einbezogen. Wähle einen genauen Pfad wie seo.title, wenn benachbarte Routing-Felder unverändert bleiben müssen. Welche Texte übersetzt werden, legst du über die Frontmatter-Optionen der gewählten Schnittstelle fest.

Wiederverwendung setzt aufeinander abgestimmte Dokumente voraus #

Der Dateihandler gleicht Texteinheiten mit dem vorherigen Quelldokument und dem zugehörigen Zieldokument ab und fügt anschließend geänderte Übersetzungen in die aktuelle Quellstruktur ein. Vorhandene Formulierungen lassen sich nur wiederverwenden, wenn sie eindeutig zugeordnet werden können. Enthalten das vorherige Quelldokument und das zugehörige Zieldokument unterschiedliche geschützte Inline-Strukturen, kann die Wiederverwendung an einer Strukturabweichung scheitern.

Bewahre die Quellversion auf, zu der die akzeptierten Formulierungen im Zieldokument gehören. Wurde das Zieldokument unabhängig davon umstrukturiert, gleiche seine Struktur mit dieser Quelle ab, bevor du eine inkrementelle Aktualisierung anforderst. Verarbeite das Ergebnis mit dem Markdown-Prozessor deiner Website, um etwaige dialektspezifische Konstrukte zu überprüfen.

Dokument konfigurieren und rendern #

Die CLI leitet md aus .md ab. Lege Dateiauswahl, Frontmatter-Felder und Ausgabepfade in der CLI-Konfiguration fest oder nutze GitHub für die verwaltete Übersetzung deines Repositorys. Die Beschränkung auf bestimmte Schlüssel über die CLI ist für Markdown nicht verfügbar.

Rendere die Ausgabe mit dem Markdown-Prozessor deiner Website. Kontrolliere dabei übersetzte Metadaten, Links, Überschriftenfragmente und Codebeispiele im Zusammenhang. Wenn /policies/delivery erhalten bleibt, wird dadurch die entsprechende Seite nicht in einer anderen Sprache erstellt. Der Leitfaden zu statischen Inhalten zeigt, wie Ausgabepfade mit der Ladelogik und den sprachspezifischen Routen deiner Website zusammenhängen.