Documentation Center

XML (Embedded Content) custom settings

The XML (Embedded Content) custom file type has the *.xml extension. This file type configuration will be deprecated in 2022. Use XML v2 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 ruleProvide the following information:
  1. Under Rule, select a rule type and an element.
  2. Under Conditions, select a condition.
  3. Under Attributes, enter an attribute, specify whether it is translatable or not, and then select plus sign.
  4. Under Properties, select Basic and edit the following:
    • Translate: Always Translatable, Not Translatable, Translatable (but not placed in protected content), Not specified
    • Tag Type: Inline, Structure, Not specified
    • Whitespace: Inherit from Parent, Always preserve, Always normalize, Normalize unless xml:space='preserve'
  5. Under Structure Information, select Add New and decide whether the structure information is inherited from the parent.
    • Under Properties, specify how descriptions are extracted (Set description from content of this relative XPath) and select a color.
    • Under Formatting, specify: the size, the color, the position (Inherit, Normal, Superscript, Subscript), and the style (Bold, Italic, Strikethrough, Underline).
  6. 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.

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.

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 you need the READ AS CHARACTER enabled or not. When you add a new entity, the WRITE AS ENTITY setting is disabled automatically.
  • 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.

Embedded Content

SettingInstruction
Process embedded content using the following processor:Select the check box and choose the available embedded content processor Embedded Content Plain Text v 1.0.0.0. Choose the location of the embedded content: CDATA sections or Document structure. CDATA stands for character data and refers to a portion of element content that is marked to be interpreted literally, as textual data, instead of marked up content.
Document Structure InformationIf you previously chose Document structure, add the document structure information:
  1. Under the Document Structure Information column, type the relevant information.
  2. Select plus sign.