Document home

XML

XML Write Options

Use this sheet to specify the options of the XML output files.

Configuration

Specifies the active configuration. You can add any number of configurations. This makes it possible to create multiple output files with different properties easily.

Language id format

Specifies how to format language ids used in xml:lang attributes. Possible values are:

Value Description
Standard: la[-Ssss][-CC] Standard language id that contains an ISO 639-1 language id (la) and optional script id (Ssss) and/or ISO-3166 country id (CC).
Legacy: la[-CC] Legacy language id that contains an ISO 639-1 language id (la) and an optional ISO-3166 country id (CC). If the id uses the secondary script of the language (e.g., Traditional Chinese), then the country id is required.
Underline: ll[_CC] As above, but separator character is underline, "_", instead of the hyphen, "-".

It is recommended to use the default language ids (either Use the same format as in the original file or Standard). Use other formats only if your files are consumed by a system that requires legacy ids.

Language id case

Specifies the case of the language attributes that are used in the file. Possible values are:

Value Description
Standard (la-CC) The language part is written in lower case. The optional country part is written in the upper case. For example, en-US for English in United States. This is the default value.
Lower (la-cc) Both language and country parts are written in lower case. For example en-us
Upper (LL-CC) Both language and country parts are written in upper case. For example EN-US

Include script into ids

Specifies when the script part is included in the language id. This is visible when language id format is set to Standard. Possible values are:

Value Description
Standard Script id is included only if it is absolutely needed to make id unambiguous. For example, English is en, Simplified Chinese is zh, and Traditional Chinese is zh-Hant.
On multiple scripts Script id is included if the language can use more that one scripts. For example, English is en, Simplified Chinese is zh-Hans, and Traditional Chinese is zh-Hant.
Always Script id is always included. For example, English is en-Latn, Simplified Chinese is zh-Hans, and Traditional Chinese is zh-Hant.

Include country into multi-script ids

Specifies when the script part is included in the language id. This is visible when language id format is set to Legacy or Underline. Possible values are:

Value Description
No A country id is not added if not implicational given. For example, English is en, Simplified Chinese is zh, and Traditional Chinese is zh-TW.
Yes A country id is included if the language has more that one possible script. For example, English is en, Simplified Chinese is zh-CN, and Traditional Chinese is zh-TW.

Localized element value that is written when there is no translation

Specifies what is written into element in the case there are no translation given. Possible values are:

Value Description Original example Localized example
Empty value
Set the value of the target element empty.
<value>Sample</value>
<value></value>
Original value Copy the source value into the value of the target element.
<value>Sample</value>
<value>Sample</value>

Add language attribute

Specifies if a xml:lang attribute is added to the localized elements. Possible values are:

Value Description
No No xml:lang attribute is added.
Root element xml:lang attribute is added only to the root element.
Localized elements xml:lang attribute is added to every element that has been localized.

If the original file contains language attributes the localized files contain them no matter what is the above setting. Soluling just updates the language value to match the target language.

Options

Specifies the formatting options when writing the localized XML files. Possible values are:

Value Description
Encode all predefined characters If checked all characters using predefined entities such as <, >, ", ' and & will always be encoded even not necessary needed.