Documentation Center

XML: Author-it Compliant settings

The XML: Author-it Compliant file type has the *.xml extension. This XML v1-based file type will be deprecated in 2022. Use XML v2-based file types instead.

Detection

SettingInstruction
Root element namesType an element name and select plus sign.
xsi:schemaLocation URIsType a declaration.
DOCTYPE declaration element namesType a declaration.
Namespace declaration (xmlns) URIsType a namespace declaration and select plus sign.
xPath rulesType an XPath rule and select plus sign.

Parser

OperationsInstruction
Add a ruleParsing rules define how elements are handled. To add a rule:
  1. Select Add New Rule.
  2. Select a rule type: Element (default), Attribute, XPath.
  3. Under Properties, select Basic and edit the following:
    • Translate: Yes (default), No, Inherit.
    • Tag Type: Structure (default), Inline.
    • Whitespace: Inherit from Parent (default), Always preserve, Always normalize, Normalize unless xml:space='preserve'
  4. Under Properties, select Advanced and edit the following:
    • SID XPATH - Leave the field empty, as this option is only used by WorldServer. For more information about SID, consult the WorldServer documentation.
    • Segmentation Hint - This option is available only if you work with inline tags and only if you specified the extraction rule (segmentation hint) in the Embedded Content section of your file type. Select one of the available options: May Exclude (default), Include, Include With Text, Exclude. Check this topic to learn what each segmentation hint does.
    • Length restrictions - Specify a minimum length and a maximum length.
  5. This option is available only if you work with inline tags. Under Formatting, specify: the size, the color, the position (Inherit, Normal, Superscript, Subscript), and the style (Bold, Italic, Strikethrough, Underline).
  6. This option is available only if you work with structure tags. Under Structure Information:
    1. Select Add new.
    2. Under Properties, select one of the available structure elements from the Name list, and then specify a code, an identifier, a description, color.
    3. Under Formatting, specify: the size, the color, the position (Inherit, Normal, Superscript, Subscript), and the style (Bold, Italic, Strikethrough, Underline).
  7. Select Done.

Writer settings

SettingInstruction
Unicode UTF-8 byte order mark (BOM)From the list, choose an option to determine how BOM is handled during translation: Preserve; don't add if not originally present, Preserve: add if not originally present, Remove if present.
Values of xml:lang and lang attributeFrom the list, choose an option to determine how 'lang' is handled during translation: Change matching source language to target language, Always change to target language, Do not change.

Whitespace settings

SettingInstruction
Whitespace in contentDecide how whitespace is treated during translation: Normalize unless xml:space='preserve' ; Always preserve; Always normalize.
Normalize whitespace in tagsSelect the check box to ensure that whitespace is normalized in tags.

Namespace settings

SettingInstruction
Namespace resolutionDecide how you want to use namespaces: Use namespaces when declared in document, Always use prefix even when namespace is declared.
NamespacesAdd a prefix and an URI for your namespace, and then select plus sign.

Embedded Content

SettingInstruction
Allow processing of content embedded in a document into tagged markup according to a set of regular expression rules. Embedded content is identified using document structure information.Toggle the button to enable the use of regular expressions when processing embedded content as translatable content.
Defined by document structure information - Document structure informationSelect or configure the document structure and then select plus sign.
Defined by document structure information - Tag definition rulesEnable this option to set the selected embedded content processors to extract embedded content from specific context. Create extraction rules based on the document structure information. Make sure that the document structure information you specify here is covered by a parser rule in the Parser settings section for your file type. Trados Studio and Trados Online Editor can only extract embedded content that is recognized by the file type parser.
  1. Select Add New Rule.
  2. From the Tag Type list, choose a value: Placeholder or Tag Pair.
  3. In the Regular expression field, enter the regular expression.
  4. Select the Ignore Case check box to ignore the case of the identified content. Otherwise, keep the default value (clear check box).
  5. From the Segmentation Hint list, choose a value from the list to determine how segmentation is performed: May Exclude (default), Include, Include With Text, Exclude. The value you specify here is available when you configure a parser rule under Parser > Add New Rule > Properties > Advanced Settings > Segmentation Hint. Check this topic to learn what each segmentation hint does.
  6. Select Save.

Entity settings

SettingInstruction
Enable entity conversionEntity settings specify whether special characters are converted to their corresponding HTML entity. Select or clear the check box depending on whether you want to have entity conversion enabled or not.
Convert numeric entity references to inline placeholder tagsSelect or clear the check box depending on whether you want to have the numeric entity conversion enabled or not.
Add an entitySelect plus sign, add the character, and decide whether the available check boxes are enabled or not: READ AS CHARACTER, WRITE AS ENTITY. When you add a new entity, the WRITE AS ENTITY setting is disabled automatically. The WRITE AS ENTITY setting only works for the default entities, and is disabled for the ones you add, which means that for the default ones characters will always be converted to entities.
  • READ AS CHARACTER - This setting specifies which entities are converted to their respective characters during parsing.
  • WRITE AS ENTITY - This setting specifies which characters are converted to their respective entities during writing.
Edit an entityAdjust the given values.

Validation

SettingInstruction
Perform schema and DTD validation during file detectionDecide how schemas and DTD files are validated:
  • Treat all validation warnings as file parsing errors
  • Report warning if no DTD/schema can be found
Perform schema validation when verifying translation
Manually specify schemaEnable this option to specify schemas manually. Decide how the schemas are used:
  • Use for all XML documents
  • Use only for documents which do not specify DTD/schema
Master SchemasKeep the default values or add more files.
Dependency Schemas and DTDsKeep the default values or add more files.