Dateitypen
-
.MD
-
.MARKDOWN
-
.MDX
Import-Optionen
-
Den Markdown-Dialekt auswählen, den der Parser beim Import der Datei verwendet. Dies wirkt sich auch darauf aus, welche Zeichen beim Import und Export automatisch maskiert/demaskiert werden.
-
Parst nur die grundlegende Markdown-Struktur (Überschriften, Absätze, Listen, einfache Hervorhebungen).
-
Parst unter Verwendung des PHP Markdown Extra / Python-Markdown „Extra“-Dialekts und fügt Unterstützung für Tabellen, Definitionslisten, Fußnoten, Abkürzungen und Attributlisten hinzu.
-
Parst unter Verwendung der GitHub Flavored Markdown (GFM)-Spezifikation und fügt Unterstützung für Tabellen, Aufgabenlisten, Durchstreichungen und automatische Links hinzu.
-
Parst die Datei als MDX: Markdown plus JSX-Komponenten, JSX-Ausdrücke (
{...}) und ESM-import/export-Anweisungen. Tabellen, Aufgabenlisten, Durchstreichungen und automatische Links funktionieren wie in GitHub Flavored Markdown. Eingerückte Codeblöcke und automatische Links in spitzen Klammern (<url>) werden nicht unterstützt, da MDX Einrückungen zum Verschachteln von Komponenten verwendet und diese Konstrukte nicht parst.MDX ist Markdown, erweitert um JSX, sodass Inhalte Komponenten und JavaScript-Ausdrücke einbetten können (zum Beispiel in Dokumentationen, die mit Docusaurus oder Next.js erstellt wurden). Der MDX-Filter wird nie automatisch ausgewählt: Er muss in den Dateiimport-Einstellungen ausgewählt werden, sowohl für .MDX-Dateien als auch für .MD-Dateien, die MDX-Syntax enthalten. Es erfolgt keine Erkennung anhand der Dateiendung oder des Inhalts.
Hinweis
Die MDX-Unterstützung muss für die Organisation aktiviert sein. Wenn MDX nicht in der Liste verfügbar ist, den Customer Success Manager oder den Phrase-Support kontaktieren.
Wichtig
Das Umstellen eines bestehenden Projekts von einem anderen Markdown-Filter auf MDX ändert die Art und Weise, wie der Inhalt segmentiert wird. Nach der Umstellung ist mit einem einmaligen Rückgang der Wiederverwendung von Übersetzungen aus dem Translation Memory zu rechnen.
-
-
Startet bei jedem harten Zeilenumbruch ein neues Segment.
-
Behält die gleiche Struktur der Leerraumzeichen im Zieldokument bei (z. B. Abstände, Zeilenumbrüche usw.).
-
Verarbeitet das YAML-Frontmatter am Anfang der Datei. Wenn ausgewählt, werden die .YAML-Importeinstellungen angewendet.
-
Extrahiert den Inhalt von Codeblöcken zur Übersetzung. Mit dem MDX-Filter gilt dies auch für Codeblöcke mit Begrenzungszeichen, die in JSX-Komponenten verschachtelt sind (zum Beispiel innerhalb von
<CodeGroup>). -
Wenn diese Option ausgewählt ist, werden Code-Elemente als einzelne Phrase TMS-Tags importiert.
-
Macht URLs für die Übersetzung verfügbar.
-
Wende reguläre Ausdrücke an, um bestimmten Text in Tags zu konvertieren.
Wichtig
Probleme mit Tags sind eine häufige Ursache für Exportfehler. Vor dem Export von Dateien immer mit Qualitätssicherungsprüfungen sicherstellen, dass Tags und Formatierung korrekt sind.
-
Die Elemente in der Datei festlegen, die in Tags konvertiert werden sollen.
-
Die Abschnitte in der Datei festlegen, die nicht importiert werden sollen.
Beispiel:
Elementname:
notrans.Code:
<notrans>Chrysler</notrans> meldete 1985 drei werksseitig vorbereitete <notrans>Dodge Shadows</notrans> für die Veranstaltung. Alle drei Fahrzeuge schieden am ersten Tag der dreitägigen <notrans>Olympus</notrans>-Rallye aus.Ergebnis: Chrysler meldete 1985 drei werksseitig vorbereitete Dodge Shadows für die Veranstaltung.Alle drei Fahrzeuge schieden am ersten Tag der dreitägigen Olympus-Rallye aus.
-
Eine Liste von Zeichen, die in der fertigen Datei nicht maskiert werden sollten (zum Beispiel
#,-,[,<,\,`,.Beim MDX-Filter werden sowohl
<als auch{standardmäßig im übersetzten Text maskiert, da ein unmaskiertes<oder{im Zieltext andernfalls die MDX-Syntax unterbrechen würde. Diese Zeichen hier nur hinzufügen, wenn sie in der Ausgabe ausdrücklich unmaskiert benötigt werden.
MDX-spezifische Optionen
Die folgenden vier Optionen sind nur verfügbar, wenn MDX unter ausgewählt ist.
-
Zusätzliche JSX-Tag-/Attribut-Paare festlegen, um sie übersetzbar zu machen. Dabei das gleiche
tag/attribute-Format verwenden wie bei der Einstellung des HTML-Filters. Zum Beispiel übersetztFigure/titledastitle-Attribut nur bei derFigure-Komponente, währendtitle(ohne Bereichsangabe) es bei jedem Tag übersetzt.Benutzerdefinierte Komponenten (Tag-Namen, die mit einem Großbuchstaben beginnen, wie
<Figure>) haben standardmäßig keine übersetzbaren Attribute und müssen daher hier explizit aufgeführt werden. Kleingeschriebene/HTML-artige Tags (<img>,<a>usw.) haben bereits standardmäßige Attributvorgaben. -
Standardmäßig aktiviert.
Wendet die Standardvorgaben für übersetzbare HTML-Attribute (zum Beispiel
altbei<img>,titlebei<a>) auf kleingeschriebene/HTML-artige Tags an, zusätzlich zu allem, was unter aufgeführt ist. Benutzerdefinierte Komponenten erhalten diese Standardvorgaben niemals, unabhängig von dieser Einstellung. Deren Attribute sind nur dann übersetzbar, wenn sie zu hinzugefügt werden.Wenn deaktiviert, sind nur die in aufgeführten Attribute übersetzbar, selbst bei kleingeschriebenen Tags.
-
Standardmäßig aktiviert.
Legt fest, ob der Text innerhalb einer JSX-Komponente standardmäßig übersetzbar ist.
-
Wenn aktiviert: Text innerhalb einer beliebigen Komponente (zum Beispiel
<Tabs>,<Note>) ist übersetzbar, es sei denn, die Komponente ist unter aufgeführt. -
Wenn deaktiviert: Text innerhalb von Komponenten ist nicht übersetzbar, es sei denn, die Komponente ist unter aufgeführt.
-
-
Eine durch Kommas getrennte Liste von Komponentennamen, die das Gegenteil der Einstellung erhalten.
Eine hier aufgeführte Komponente wird als Ganzes umgestellt: Der gesamte Inhalt, einschließlich aller darin verschachtelten Komponenten, folgt der abweichenden Einstellung und wird nicht einzeln ausgewertet. Wenn die abweichende Einstellung eine Komponente als nicht übersetzbar festlegt, bleibt ihr Inhalt exakt so erhalten, wie er geschrieben wurde. Mit dieser Liste lassen sich:
-
einige Komponenten ohne Fließtext ausschließen (zum Beispiel
CodeGroup,Mermaid), wenn aktiviert ist, oder -
einige Komponenten mit Fließtext gezielt für die Übersetzung freigeben, wenn diese Einstellung deaktiviert ist.
-
Wie JSX-Inhalte gehandhabt werden
Dies gilt, wenn MDX unter ausgewählt ist.
-
JSX-Tags (
<Component>,<Component attr="value" />) sowie Tag- und Attributnamen sind niemals übersetzbar. Nur Elementinhalte und die explizit konfigurierten Werte von Attributen sind übersetzbar. -
Ausdrücke in geschweiften Klammern (
{...}), JavaScript-Ausdrücke, Spread-Attribute ({...props}) und Kommentare ({/* comment */}) sind niemals übersetzbar. Sie bleiben exakt so erhalten, wie sie geschrieben wurden – unabhängig davon, ob sie in Attributen, direkt im Text oder in einer eigenen Zeile stehen. -
import- undexport-Anweisungen sind unabhängig von ihrer Position in der Datei immer von der Übersetzung ausgeschlossen.