Dateiimport-Einstellungen

.MD / .MDX - Markdown und MDX (TMS)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Dateitypen

  • .MD

  • .MARKDOWN

  • .MDX

Import-Optionen

  • Filtern 

    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.

    • Normal

      Parst nur die grundlegende Markdown-Struktur (Überschriften, Absätze, Listen, einfache Hervorhebungen).

    • PHP/Python Markdown Extra

      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.

    • GitHub Flavored Markdown

      Parst unter Verwendung der GitHub Flavored Markdown (GFM)-Spezifikation und fügt Unterstützung für Tabellen, Aufgabenlisten, Durchstreichungen und automatische Links hinzu.

    • MDX

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

  • Neues Segment bei hartem Zeilenumbruch 

    Startet bei jedem harten Zeilenumbruch ein neues Segment.

  • Leerzeichen beibehalten 

    Behält die gleiche Struktur der Leerraumzeichen im Zieldokument bei (z. B. Abstände, Zeilenumbrüche usw.).

  • YAML-Header verarbeiten 

    Verarbeitet das YAML-Frontmatter am Anfang der Datei. Wenn ausgewählt, werden die .YAML-Importeinstellungen angewendet.

  • Code-Blöcke importieren 

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

  • Code-Elemente ausschließen 

    Wenn diese Option ausgewählt ist, werden Code-Elemente als einzelne Phrase TMS-Tags importiert.

  • URLs als übersetzbar markieren

    Macht URLs für die Übersetzung verfügbar.

  • In Phrase TMS-Tags konvertieren 

    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.

  • Benutzerdefinierte Elemente (in Phrase-Tags konvertiert) 

    Die Elemente in der Datei festlegen, die in Tags konvertiert werden sollen.

  • Nicht übersetzbare Blöcke 

    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.

  • Zeichen nicht maskieren 

    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 Filter ausgewählt ist.

  • Übersetzbare Attribute

    Zusätzliche JSX-Tag-/Attribut-Paare festlegen, um sie übersetzbar zu machen. Dabei das gleiche tag/attribute-Format verwenden wie bei der Einstellung Translatable attributes des HTML-Filters. Zum Beispiel übersetzt Figure/title das title-Attribut nur bei der Figure-Komponente, während title (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 übersetzbare Attribute importieren

    Standardmäßig aktiviert.

    Wendet die Standardvorgaben für übersetzbare HTML-Attribute (zum Beispiel alt bei <img>, title bei <a>) auf kleingeschriebene/HTML-artige Tags an, zusätzlich zu allem, was unter Translatable attributes aufgeführt ist. Benutzerdefinierte Komponenten erhalten diese Standardvorgaben niemals, unabhängig von dieser Einstellung. Deren Attribute sind nur dann übersetzbar, wenn sie zu Translatable attributes hinzugefügt werden.

    Wenn deaktiviert, sind nur die in Translatable attributes aufgeführten Attribute übersetzbar, selbst bei kleingeschriebenen Tags.

  • Elemente standardmäßig übersetzbar machen

    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 Elements overriding default translatability aufgeführt.

    • Wenn deaktiviert: Text innerhalb von Komponenten ist nicht übersetzbar, es sei denn, die Komponente ist unter Elements overriding default translatability aufgeführt.

  • Elemente, die die Standard-Übersetzbarkeit außer Kraft setzen

    Eine durch Kommas getrennte Liste von Komponentennamen, die das Gegenteil der Einstellung Make elements translatable by default 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 Make elements translatable by default 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 Filter 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- und export-Anweisungen sind unabhängig von ihrer Position in der Datei immer von der Übersetzung ausgeschlossen.

War dieser Beitrag hilfreich?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.