Documentation Center

Example - the Parser Rules used in XML-Letter

The parser rules define how the XML-letter file type is handled by the file type support software.

We want to handle elements of the XML-letter file type as follows:
XML ElementTranslatableNotes
<letter>No

This is the root element and represents the letter structure.

<title maxlength="50">Yes

These elements have been inserted to show how you can handle sections of text that have length restrictions.

<title maxlength="40">Yes
<salutation>Yes

"Dear Daniel " should be translated.

<text>Yes

The body of the letter should be translated.

<component translate="yes">Yes

These elements have been inserted to show how you can handle sections of text that have been tagged translatable or not translatable.

<component translate="no">No
<emphasis>Yes

The emphasis tag changes the format of the text but the text should still be translated.

<signature>No

We do not translate a person's name or address.

<address>No
<weblink>No

We do not alter the web address.

<logo alt>Yes

The logo alt text should be in the local language.

<logo address>No

We do not change the web address.

The parser rules to achieve that result are as follows:
Element @attribute=...XPathTranslate SettingsTag Type
(any) @translatable="yes"//*[@translatable = 'yes']TranslatableInline
(any) @translatable="no"//*[@translatable = 'no'] Not translatableInline
salutation//salutationTranslatableStructure
text//textTranslatableStructure
emphasis//emphasisNot specifiedInline
signature//signature Not translatableStructure
address//address Not translatableStructure
weblink//weblinkNot translatableStructure
logo @alt=...//logo/@altTranslatableInline
logo @address=...//logo/@addressNot translatableStructure
All other elements are covered by this, the last rule in the rules table//*Not translatable

The whitespace handling for all these elements is Inherit from parent.