Parser Konfiguration Settings
Standardmäßig verwendet Crowdin für jedes unterstützte Dateiformat einen vordefinierten Satz von Import- und Exportparametern.
Mit der Parserkonfiguration kannst du das für von Crowdin unterstützte Dateiformate vordefinierte Import- und Exportverhalten ändern. Parser Konfiguration in ein bestimmten Projekt ist applied nur zu Dateien gespeichert in dies Projekt.
Du kannst festlegen die parser Konfiguration für alle Dateien von ein certain Format oder single Dateien. Parser configuration in a specific project is applied only to files stored in this project.
Die meisten unterstützten Dateiformate verfügen über konfigurierbares Import- und Exportverhalten.
einige parameters sind common zu alle Formate, während andere sind Format-bestimmten.
in die table below, du kann see die verfügbar parser parameters und Formate sie könnte sein konfiguriert für.
| Parameter | Beschreibung | Format |
|---|---|---|
| Inhaltssegmentierung | Beim Import wird der Inhalt der Quelldatei mithilfe vordefinierter Segmentierungsregeln (SRX 2.0) in kürzere Textsegmente aufgeteilt. | Generisches XML, DITA, AsciiDoc, MadCap Flare, HTML, Office-Dokumente, Adobe FrameMaker, Adobe InDesign, Markdown |
| Benutzerdefinierte Segmentierungsregeln | Definiert deine eigenen Segmentierungsregeln. Erfahre mehr über Benutzerdefinierte Segmentierung. | Generisches XML, DITA, AsciiDoc, Reine Textdatei, MadCap Flare, HTML, Office-Dokumente, Adobe FrameMaker, Adobe InDesign, Markdown, MediaWiki |
| Ausgeschlossene Elemente | Definiert eine Liste von CSS-Stil-Selektoren für Elemente, die nicht zur Übersetzung zur Verfügung stehen sollen (z. B. code, pre > code, .code-block). Trifft nur auf Block-Elemente zu. Inline-Elemente werden ignoriert. | HTML, HTML (mit Front Matter) |
| Inline-Tags | Definiert eine Liste von Tags, die als Inline-Elemente statt als Blockelemente behandelt werden sollen (z. B. item, list). Der Text innerhalb eines Inline-Tags bleibt Teil des umgebenden Strings. | Generisches XML, HTML, HTML (mit Front Matter), Markdown, WebXml |
| Attributwerte ausblenden | HTML-Attribute wie src, href und data werden als ausgeblendete Strings importiert und den Übersetzern nicht angezeigt. | HTML, HTML (mit Front Matter), WebXml |
| Ausgeschlossene Front-Matter-Elemente | Definiert eine Liste von Front-Matter-Elementen, die nicht zur Übersetzung zur Verfügung stehen sollen (z. B. keywords, “internal.description”, tags). Die Pfadelemente sollten durch einen Punkt getrennt werden. Schlüssel, die einen Punkt enthalten, müssen in Anführungszeichen eingeschlossen werden. | HTML (mit Front Matter), Markdown, MDX |
| Anführungszeichen für den Export von Front Matter | Legt fest, wie Front-Matter-Werte in exportierten Dateien in Anführungszeichen gesetzt werden. Standard setzt nur Werte, die einen Doppelpunkt enthalten, in Anführungszeichen. Die beiden anderen Optionen setzen jeden Wert in einfache oder doppelte Anführungszeichen. | Markdown |
| Code-Blöcke ausschließen | Definiert, ob Code-Blöcke importiert werden sollen. Trifft nur auf Code-Blöcke zu. Inline-Elemente mit Code werden ignoriert. | Markdown, MDX |
| Marker für Fettdruck | Definiert den Marker, der für hervorgehobenen Text in exportierten Dateien verwendet wird: entweder Sternchen (*) oder Unterstrich (_). | Markdown, MDX |
| Marker für Kursivschrift | Definiert den Marker, der für kursiv hervorgehobenen Text in exportierten Dateien verwendet wird: entweder Sternchen (*) oder Unterstrich (_). | Markdown, MDX |
| Aufzählungszeichen für ungeordnete Listen | Definiert das Zeichen, mit dem jedes Element einer ungeordneten Liste in exportierten Dateien beginnt: Bindestrich (-), Sternchen (*) oder Pluszeichen (+). | Markdown, MDX |
| Tabellenformatierung | Legt fest, wie Tabellenspalten in exportierten Dateien formatiert werden. Zellen gleichmäßig verteilen füllt jede Spalte bis zur Länge ihres längsten Werts auf, während Konsolidieren auf beiden Seiten jedes Werts ein Leerzeichen lässt. | Markdown, MDX |
| Inhalt übersetzen | Texte innerhalb der Tags stehen zur Übersetzung zur Verfügung. | Generisches XML |
| Attribute übersetzen | Tag-Attribute stehen zur Übersetzung zur Verfügung. | Generisches XML |
| Übersetzbare Elemente | Definiert die spezifischen Knoten und Attribute, die für die Übersetzung zur Verfügung stehen sollen. | Generisches XML |
| Einfaches Anführungszeichen maskieren | Definiert das Verhalten bezüglich der Maskierung von einfachen Anführungszeichen in exportierten Übersetzungen.
| Java Properties |
| Sonderzeichen maskieren | Alle Sonderzeichen (z. B., | Java Properties |
| Anführungszeichen für den Export | Legt fest, ob exportierte Strings in einfache oder doppelte Anführungszeichen eingeschlossen werden. | JavaScript |
| Include-Direktiven überspringen | include::-Direktiven werden nicht verarbeitet, sodass der Inhalt der Dateien, auf die sie verweisen, nicht in dieser Datei enthalten ist. Nützlich, wenn diese Dateien eigenständig in Crowdin hochgeladen werden und ihr Text dort bereits übersetzt ist. | AsciiDoc |
| Hyperlinktext inline extrahieren | Der Text eines Hyperlinks wird zusammen mit dem umgebenden Satz extrahiert, sodass Übersetzer ihn im Kontext statt als separates, nicht bearbeitbares Tag sehen. | Adobe InDesign |
| In ICU MessageFormat konvertieren | Platzhalter werden beim Import in die ICU-MessageFormat-Syntax konvertiert. | Steamworks-Lokalisierung |
| Variablen beim Konvertieren der VDF-Gendersyntax in ICU Select mit „_gender“ kennzeichnen | Variablennamen wird beim Konvertieren der Gendersyntax das Suffix _gender hinzugefügt. Verfügbar, wenn In ICU MessageFormat konvertieren aktiviert ist. | Steamworks-Lokalisierung |
| Bezeichner (Schlüssel) als Quellstring importieren | Wenn eine Datei keinen Quelltext für einen String enthält, wird dessen Bezeichner als Quellstring importiert. | String Catalog |
| Übersetzungen importieren | Bereits in der Datei gespeicherte Übersetzungen werden zusammen mit den Quellstrings importiert. | String Catalog |
| Tags aggressiv bereinigen | Zusätzliche Formatierungs-Tags zur Textabstandsregelung werden beim Import entfernt. Nützlich beim Übersetzen von Office-Dokumenten, die aus anderen Formaten (zum Beispiel PDF) konvertiert wurden und bei denen durch die Konvertierung viele unnötige Formatierungs-Tags entstanden sind. | Office-Dokumente, Microsoft Visio |
| Hyperlink-URLs übersetzen | Hyperlink-URLs stehen zur Übersetzung zur Verfügung. | Office-Dokumente, Microsoft Visio |
Office-Dokumente verfügen über einen eigenen Satz von Parametern, die hier wie im Einstellungsdialog gruppiert sind.
| Parameter | Beschreibung |
|---|---|
| Dokumenteigenschaften übersetzen | Dokumenteigenschaften wie Titel, Betreff und Ersteller stehen zur Übersetzung zur Verfügung. |
| Kommentare übersetzen | Im Dokument vorhandene Kommentare stehen zur Übersetzung zur Verfügung. Standardmäßig aktiviert. |
| Tags aggressiv bereinigen | Zusätzliche Formatierungs-Tags zur Textabstandsregelung werden beim Import entfernt. Nützlich beim Übersetzen von Office-Dokumenten, die aus anderen Formaten (zum Beispiel PDF) konvertiert wurden und bei denen durch die Konvertierung viele unnötige Formatierungs-Tags entstanden sind. |
| Formatierung ignorieren, die sich nur durch Leerzeichen unterscheidet | Ein Leerzeichen mit eigener Formatierung übernimmt die Formatierung des angrenzenden Texts, sodass es dem String kein zusätzliches Tag-Paar mehr hinzufügt. Verfügbar, wenn Tags aggressiv bereinigen aktiviert ist. |
| Tabulatoren als Zeichen anzeigen | Ein Tabulator innerhalb einer Textzeile wird im String als Zeichen statt als Tag angezeigt. |
| Zeilenumbrüche als Zeichen anzeigen | Ein Zeilenumbruch innerhalb einer Textzeile wird im String als das unter Ersetzung für Zeilenumbrüche festgelegte Zeichen statt als Tag angezeigt. |
| Ersetzung für Zeilenumbrüche | Definiert das einzelne Zeichen, das einen Zeilenumbruch ersetzt, zum Beispiel ein Leerzeichen oder einen senkrechten Strich. Verfügbar, wenn Zeilenumbrüche als Zeichen anzeigen aktiviert ist. |
| Geschützte Bindestriche als Zeichen anzeigen | Ein geschützter Bindestrich wird im String als Zeichen statt als Tag angezeigt. |
| Weiche Trennstriche ignorieren | Weiche Trennstriche werden entfernt, statt als Tags angezeigt zu werden. |
| Hyperlink-URLs übersetzen | Hyperlink-URLs stehen zur Übersetzung zur Verfügung. |
| Parameter | Beschreibung |
|---|---|
| Kopf- und Fußzeilen übersetzen | Kopf- und Fußzeilen stehen zur Übersetzung zur Verfügung. Standardmäßig aktiviert. |
| Versteckten Text übersetzen | Versteckter Text steht zur Übersetzung zur Verfügung. |
| Namen von Formen und Bildern übersetzen | Der Name einer Form oder eines Bildes steht zur Übersetzung zur Verfügung. Standardmäßig aktiviert. |
| Alternativtexte von Formen und Bildern übersetzen | Der Alternativtext einer Form oder eines Bildes steht zur Übersetzung zur Verfügung, wodurch das lokalisierte Dokument für Screenreader zugänglich bleibt. |
| Zusätzliche zu übersetzende Feldtypen | Definiert eine Liste von Word-Feldtypen, deren Text zur Übersetzung zur Verfügung steht. Verwende die Feldcodes so, wie Word sie schreibt (zum Beispiel PAGE). HYPERLINK wird unabhängig davon übersetzt, ob es in der Liste enthalten ist. |
| Absatzformatvorlagen | Definiert eine Liste von Namen von Absatzformatvorlagen, wie sie im Dokument angezeigt werden (zum Beispiel Heading1, Quote). Wähle Die aufgelisteten Formatvorlagen ausschließen, um sie auszulassen, oder Nur die aufgelisteten Formatvorlagen übersetzen, um nichts anderes zu übersetzen. |
| Hervorhebungsfarben | Definiert eine Liste der Word-Farben für Hervorhebungen. Wähle Die aufgelisteten Hervorhebungsfarben ausschließen, um den von ihnen markierten Text auszulassen, oder Nur die aufgelisteten Hervorhebungsfarben übersetzen, um nichts anderes zu übersetzen. Verfügbare Farben: black, blue, cyan, green, magenta, red, yellow, white, darkBlue, darkCyan, darkGreen, darkMagenta, darkRed, darkYellow, darkGray, lightGray, none. |
| Text in den aufgelisteten Farben ausschließen | Text in den aufgelisteten Farben steht nicht zur Übersetzung zur Verfügung. Jede Farbe besteht aus sechs Hexadezimalziffern und muss genau übereinstimmen, sodass auch ein ähnlicher Farbton übersetzt wird. |
| Parameter | Beschreibung |
|---|---|
| Versteckte Zeilen und Spalten übersetzen | Versteckte Zeilen und Spalten stehen zur Übersetzung zur Verfügung. |
| Arbeitsblattnamen übersetzen | Arbeitsblattnamen stehen zur Übersetzung zur Verfügung. |
| Text in Zeichnungen und Formen übersetzen | Text in Zeichnungen und Formen eines Arbeitsblatts steht zur Übersetzung zur Verfügung. |
| SmartArt- und Diagrammtext übersetzen | Text in SmartArt-Grafiken und Diagrammdaten steht zur Übersetzung zur Verfügung. |
| Parameter | Beschreibung |
|---|---|
| Versteckte Folien importieren | Versteckte Folien stehen zur Übersetzung zur Verfügung. |
| Importhinweise | Die Notizen der Folien stehen zur Übersetzung zur Verfügung. Standardmäßig aktiviert. |
Parser Konfiguration für alle Project Files von ein bestimmten Format
Abschnitt betitelt „Parser Konfiguration für alle Project Files von ein bestimmten Format“Um festlegen die preferred parser Konfiguration für alle Dateien von ein bestimmten Format, folgen diese Schritten:
- Öffne dein Projekt und gehe zu Einstellungen > Parser-Konfiguration.
- Wähle die benötigt Datei Format und klicke auf Edit.
- Lege die preferred Einstellungen. fest
- Klicke auf Speichern.
Alternativ kannst du bei Formaten mit konfigurierbaren Parsereinstellungen dieselben Einstellungen über den Dialog Bundle erstellen oder Bundle bearbeiten öffnen, indem du neben dem gewünschten Format auf klickst.
Um ein neues Dateiformat hinzuzufügen, klicke oben rechts auf Apps hinzufügen und installiere das erforderliche Format.
Parser Konfiguration für ein Single File
Abschnitt betitelt „Parser Konfiguration für ein Single File“in einige cases, du könnte benötigen zu festlegen die parser Konfiguration nicht für alle Dateien von einige Datei Format aber just für ein single Datei. Um festlegen die parser Konfiguration für ein single Datei, folgen diese Schritten:
- Öffne dein Projekt und gehe zu Quellen > Dateien.
- Double-klicken auf die benötigt Datei.
- Wechsle im geöffneten Dialog zum Tab Parser-Konfiguration.
- Lege die preferred Einstellungen. fest
- Klicke auf Speichern.
Sobald du die Dateiparserkonfiguration speicherst, importiert Crowdin diese Datei erneut und wendet deine Einstellungen an.
Mehr über die Dateiverwaltung in Crowdin erfährst du hier.
Post-Verarbeitung Files mit Nested Inhalt
Abschnitt betitelt „Post-Verarbeitung Files mit Nested Inhalt“Sometimes, du könnte arbeiten mit Dateien das enthalten Strings in ein unterschiedlich Format. ein common example ist ein JSON Datei wo einige String Werte enthalten HTML Inhalt. die Standard parser Konfiguration isn’t designed für diese nested oder cascading scenarios.
Um properly Prozess such Dateien, du benötigen zu implement ein benutzerdefiniert Crowdin App das verwendet die File Post-importieren Verarbeitung Modul. Mit dieser Methode, die manchmal als Kaskadenverarbeitung bezeichnet wird, kann deine App importierte Strings abfangen und Crowdin anweisen, bestimmte Strings mit einem anderen Parser erneut zu verarbeiten. Du kannst Crowdin beispielsweise anweisen, einen String aus einer JSON-Datei als HTML zu parsen, damit HTML-Tags korrekt verarbeitet und Übersetzern nicht als Klartext angezeigt werden.
Um handle Dateien mit nested Inhalt, du kann install die Cascade Importer von die Crowdin Store oder, für mehr benutzerdefiniert scenarios, build dein own.