Конфігурація парсерів

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.

You can configure import and export behavior for the following formats: Java Properties, Generic XML, DITA, AsciiDoc, Plain text, MadCap Flare, HTML, Office documents, Adobe FrameMaker, Adobe InDesign, Markdown, and MediaWiki.

Note: Some parser settings may be unavailable in string-based projects.

Parser configuration

Parser Configuration Parameters

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.

Параметр Опис Format
Content segmentation On import, the source file's content will be split into shorter text segments using predefined segmentation rules (SRX 2.0). Generic XML, DITA, AsciiDoc, MadCap Flare, HTML, Office documents, Adobe FrameMaker, Adobe InDesign, Markdown
Custom segmentation rules Defines your own segmentation rules.
Read more about Custom Segmentation.
Note: The Content segmentation option should be enabled to be able to enable and define Custom segmentation rules.
Generic XML, DITA, AsciiDoc, Plain text, MadCap Flare, HTML, Office documents, Adobe FrameMaker, Adobe InDesign, Markdown, MediaWiki
Excluded elements Defines a list of CSS style selectors for elements that should not be available for translation (e.g., code, pre > code, .code-block). Applicable only to block elements. Inline elements are ignored. HTML, HTML with Front Matter
Excluded front matter elements Defines a list of front matter elements that should not be available for translation (e.g., keywords, "internal.description", tags). The path elements should be delimited by a period. The keys containing a period must be enclosed in quotation marks. HTML with Front Matter, MDX
Exclude code blocks Defines whether to import code blocks. Applicable only to code blocks. Inline elements with code are ignored. MDX
Translate content Texts stored inside the tags will be available for translation. Generic XML
Translate attributes Tag attributes will be available for translation. Generic XML
Translatable elements Defines the specific nodes and attributes to be available for translation.
Note: If defined, the parameters Translate content and Translate attributes are ignored on import.
Generic XML
Escape single quote Defines the behavior regarding a single quote escaping in exported translations.
Available options:
  • Do not escape single quote
  • Escape single quote by backslash (It's okayIt\'s okay)
  • Escape single quote by another single quote (It's okayIt''s okay)
  • Escape single quote by another single quote only in strings containing variables {0} ({0} it's okay{0} it''s okay)
Властивості Java
Escape special characters Any special characters (i.e., =, :, !, #) will be escaped by a backslash \ in exported translations. Властивості Java
Clean tags aggressively Additional formatting tags related to text spacing will be removed on import. Useful when translating Office documents converted from other formats (e.g., PDF, etc.), and the conversion introduced lots of unnecessary formatting tags. Office documents
Translate hyperlink URLs Hyperlink URLs will be available for translation. Office documents
Translate hidden text The hidden text will be available for translation. Office documents
Translate hidden rows and columns The hidden rows and columns will be available for translation. Office documents
Import hidden slides The hidden slides will be available for translation. Office documents
Import notes The slide notes will be available for translation. Office documents

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:

  1. Open your project and go to Settings > Parser configuration.
  2. Click Add file type.
  3. Choose the needed file format.
  4. Set the preferred settings.
  5. Click Save.

Parser Configuration for a Single File

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:

  1. Open your project and go to Sources > Files.
  2. Double-click on the needed file.
  3. In the appeared dialog, switch to the Parser configuration tab.
  4. Set the preferred settings.
  5. Click Save.

Once you save the file parser configuration, Crowdin will reimport this file and apply your settings.

Дивись також

Ця стаття була корисною?