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 the language IDs that are written to the file, such as the xml:lang attributes. Possible values are:

Value	Description
Standard: ll[-Ssss][-CC]	Standard language ID that contains an ISO 639 language code (ll), an optional ISO 15924 script code (Ssss), and an optional ISO 3166 country code (CC). For example, `sr-Latn-RS`. This is the default value.
Legacy: ll[-CC]	Legacy language ID that contains an ISO 639 language code (ll) and an optional ISO 3166 country code (CC), but no script code. If the ID uses the secondary script of the language, a country code and, for some languages, a script variant are added. For example, Traditional Chinese is `zh-TW`, and Serbian (Latin) is `sr-RS-LAT`.
Underline: ll[_CC]	As above, but the separator is an underscore, "_", instead of a hyphen, "-". For example, `zh_TW`.

We recommend using the standard language IDs. Use the other formats only if your files are read by a system that requires legacy IDs.

Language ID character case

Specifies the character case of the language IDs that are written to the file. Possible values are:

Value	Description
Standard (ll-CC)	The language part is written in lower case, the optional script part is capitalized, and the optional country part is written in upper case. For example, `en-US` and `sr-Latn-RS`. This is the default value.
Lower (ll-cc)	All parts are written in lower case. For example, `en-us` and `sr-latn-rs`.
Upper (LL-CC)	All parts are written in upper case. For example, `EN-US` and `SR-LATN-RS`.

Include script into IDs

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

Value	Description
Standard	The script code is included only if the language does not use its default script. For example, English is `en`, Simplified Chinese is `zh`, and Traditional Chinese is `zh-Hant`. This is the default value.
On multiple scripts	The script code is included if the language can use more than one script. For example, English is `en`, Simplified Chinese is `zh-Hans`, and Traditional Chinese is `zh-Hant`.
Always	The script code 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 country part is included in the language ID of a language that can use more than one script. This is visible when the language ID format is Legacy or Underline. Possible values are:

Value	Description
No	The country code is added only when it is needed to identify the script. For example, English is `en`, Simplified Chinese is `zh`, and Traditional Chinese is `zh-TW`. This is the default value.
Yes	The country code is always added if the language can use more than one 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 is 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 an 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.