How Translation Processing Handles XML Language Attribute Values

During import of a translation package, the xml:lang attribute values on document elements are processed according to the option selected in the application document.

When a translation package is imported back into the repository, xml:lang attribute values on a document's root elements and child elements are handled based on the option selection set in the xml:lang attribute processing type field in the application document. See Configuring Translation Options.

Processing may assign or change xml:lang attribute values in the translated documents, based on the option selected, and determined by the language and locale values of the source and target language cabinets.

Note:

Your source language documents may not all have an xml:lang attribute value present on the root element. In this case, the document inherits the value from the source document's cabinet.
An xml:lang attribute value and the language and locale properties of the source and target language cabinets can be specified with just a language value (for example, en for English), or with a language/locale value (for example, en_US for American English.
When comparing language or language/locale strings, attribute value processing ignores case.
The separator character used between the language and locale codes can be different (a hyphen or an underscore), but they are treated as the same when matching. For example, en-US and en_US are considered to be the same language/locale value during processing.

Processing for the xml:lang attribute values occurs as follows:

Processing Type Selection	Processing Results
Top Level Only	Changes only the xml:lang attribute value on the root element of the document to match the language or language/locale of the target language cabinet. If no xml:lang attribute is present on the root element, processing creates one to match that of the target language cabinet. If xml:lang attribute values are present on descendant elements, they are not changed.
Language and Country Match	Processing first looks at the root element for an xml:lang attribute. If none is present, initially it gets assigned the language/locale from the document's source cabinet. The root element's xml:lang attribute value is then changed to match the language/locale of the target language cabinet. After processing the root element, descendant elements with xml:lang attributes that matched the document's root element language/local are changed to the language/locale of the target language cabinet. If an attribute has only a language value, but the target language cabinet has a language/locale value, attribute values are changed to match the language/locale value. If the target language cabinet has only a language value, attribute values are changed to match the language value.
Language Match	Processing first looks at the root element for an xml:lang attribute. If none is present, it gets assigned the language from the document's source cabinet. The root element's xml:lang attribute value is then changed to match the language of the target language cabinet. After processing the root element, descendant elements with xml:lang attributes that matched the document's root element language are changed to the language of the target language cabinet. If an attribute has only a language value, but the target language cabinet has a language /locale value, attribute values are changed to match the language/locale value. If the target language cabinet has only a language value, attribute values are changed to the language value.
All	Processing first looks at the root element for an xml:lang attribute. If none is present, it gets assigned the language or language/locale from the document's source cabinet. The root element's xml:lang attribute value is then changed to match the language or language/locale of the target language cabinet. After processing the root element, all descendant elements with xml:lang attribute values, regardless of whether they match, are changed to the language or language/locale values of the target cabinet.
None	No xml:lang attributes are changed.