Parser Configuration Settings
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
In Crowdin übersetzenBy default, Crowdin uses a predefined set of import and export parameters for each supported file format.
The Parser configuration feature lets you change the default import and export behavior predefined for file formats supported by Crowdin. Parser configuration in a specific project is applied only to files stored in this project.
You can set the parser configuration for all files of a certain format or single files. Once you save the parser configuration for some file format, you can upload source files to your project, and Crowdin will apply your settings accordingly.
Most of the supported file formats have configurable import and export behavior.
Some parameters are common to all formats, while others are format-specific.
In the table below, you can see the available parser parameters and formats they could be configured for.
| 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 |
| 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 with Front Matter, MDX |
| 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. | 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 |
| Tags aggressiv bereinigen | Zusätzliche Formatierungs-Tags zur Textabstandsregelung werden beim Import entfernt. Nützlich beim Übersetzen von Office-Dokumenten, die aus anderen Formaten (z. B. PDF etc.) konvertiert wurden und bei denen durch die Konvertierung viele unnötige Formatierungs-Tags entstanden sind. | Office-Dokumente |
| Hyperlink-URLs übersetzen | Hyperlink-URLs stehen zur Übersetzung zur Verfügung. | Office-Dokumente |
| Versteckten Text übersetzen | Versteckter Text steht zur Übersetzung zur Verfügung. | Office-Dokumente |
| Versteckte Zeilen und Spalten übersetzen | Versteckte Zeilen und Spalten stehen zur Übersetzung zur Verfügung. | Office-Dokumente |
| Versteckte Folien importieren | Versteckte Folien stehen zur Übersetzung zur Verfügung. | Office-Dokumente |
| Notizen importieren | Die Foliennotizen stehen zur Übersetzung zur Verfügung. | Office-Dokumente |
Office documents have their own set of parameters, grouped here as they are in the settings dialog.
General Options
| Parameter | Description |
|---|---|
| Translate document properties | Document properties such as title, subject, and creator will be available for translation. |
| Translate comments | Comments left in the document will be available for translation. Enabled by default. |
| Clean tags aggressively | Additional formatting tags related to text spacing will be removed on import. Useful when translating Office documents converted from other formats (for example, PDF), and the conversion introduced lots of unnecessary formatting tags. |
| Ignore formatting that differs only in whitespace | A space with its own formatting will take the formatting of the text next to it, so it no longer adds a tag pair to the string. Available when Clean tags aggressively is enabled. |
| Show tabs as characters | A tab inside a line of text will appear in the string as a character instead of a tag. |
| Show line breaks as characters | A line break inside a line of text will appear in the string as the character set in Line break replacement instead of a tag. |
| Line break replacement | Defines the single character that replaces a line break, for example a space or a pipe. Available when Show line breaks as characters is enabled. |
| Show non-breaking hyphens as characters | A non-breaking hyphen will appear in the string as a character instead of a tag. |
| Ignore soft hyphens | Soft hyphens will be removed instead of appearing as tags. |
| Translate hyperlink URLs | Hyperlink URLs will be available for translation. |
Text Documents
| Parameter | Description |
|---|---|
| Translate headers and footers | Headers and footers will be available for translation. Enabled by default. |
| Translate hidden text | The hidden text will be available for translation. |
| Translate shape and image names | The name of a shape or an image will be available for translation. Enabled by default. |
| Translate shape and image alternative text | The alternative text of a shape or an image will be available for translation, which keeps the localized document accessible to screen readers. |
| Additional field types to translate | Defines a list of Word field types whose text will be available for translation. Use the field codes as Word writes them (for example, PAGE). HYPERLINK is translated whether or not it appears in the list. |
| Paragraph styles | Defines a list of paragraph style names, as they appear in the document (for example, Heading1, Quote). Select Exclude the listed styles to leave them out, or Translate only the listed styles to translate nothing else. |
| Highlight colors | Defines a list of Word highlight colors. Select Exclude the listed highlight colors to leave the text they mark out, or Translate only the listed highlight colors to translate nothing else. Available colors: black, blue, cyan, green, magenta, red, yellow, white, darkBlue, darkCyan, darkGreen, darkMagenta, darkRed, darkYellow, darkGray, lightGray, none. |
| Exclude text in the listed colors | Text in the listed colors will not be available for translation. Each color is six hexadecimal digits and must match exactly, so a similar shade is still translated. |
Spreadsheets
| Parameter | Description |
|---|---|
| Translate hidden rows and columns | The hidden rows and columns will be available for translation. |
| Translate worksheet names | Worksheet names will be available for translation. |
| Translate text in drawings and shapes | Text inside drawings and shapes on a worksheet will be available for translation. |
| Translate SmartArt and diagram text | Text inside SmartArt graphics and diagram data will be available for translation. |
Slides
| Parameter | Description |
|---|---|
| Import hidden slides | The hidden slides will be available for translation. |
| Import notes | The slide notes will be available for translation. Enabled by default. |
Parser Configuration for All Project Files of a Specific Format
Section titled “Parser Configuration for All Project Files of a Specific Format”To set the preferred parser configuration for all files of a specific format, follow these steps:
- Open your project and go to Settings > Parser configuration.
- Choose the needed file format and click Edit.
- Set the preferred settings.
- Click Save.
Alternatively, for formats with configurable parser settings, you can open the same settings from the Create bundle or Edit bundle dialog by clicking next to the target format.
To add a new file format, click Add Apps at the upper right and install the required format.
In some cases, you might need to set the parser configuration not for all files of some file format but just for a single file. To set the parser configuration for a single file, follow these steps:
- Open your project and go to Sources > Files.
- Double-click on the needed file.
- In the appeared dialog, switch to the Parser configuration tab.
- Set the preferred settings.
- Click Save.
Once you save the file parser configuration, Crowdin will reimport this file and apply your settings.
Read more about file management in Crowdin.
Sometimes, you might work with files that contain strings in a different format. A common example is a JSON file where some string values contain HTML content. The standard parser configuration isn’t designed for these nested or cascading scenarios.
To properly process such files, you need to implement a custom Crowdin App that uses the File Post-Import Processing Module. This method, sometimes referred to as cascade processing, allows your app to intercept imported strings and instruct Crowdin to re-process specific ones using a different parser. For instance, you can tell Crowdin to parse a string from a JSON file as HTML, ensuring that HTML tags are correctly handled and not exposed to translators as plain text.
To handle files with nested content, you can install the Cascade Importer from the Crowdin Store or, for more custom scenarios, build your own.