Soluling home   Document home

TMX Write Options

TMX Write Options

This sheet specifies the options of localized TMX 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 resources contain

Specifies what resource items are written to the localized resource files. Possible values are:

Value Description
Different items If checked, Soluling writes only those resource items where the value of the item is different from the original value. If the edit sheet has a translation, but it is the same as the original, the value is not written. This is the default value.
Translated items

If checked, Soluling writes those resource items that are translated. In other words, a value has been entered into an edit sheet.

All items If checked, Soluling writes all resource items to the localized resource file. If no translation is entered in the edit sheet, the original value is written.

If you use Different items or Translated items, value Soluling can greatly optimize the localized resource files' size. This will also fully enable the platform's build-in language fallback (e.g., .NET, Android, or Java). If you choose All items, no runtime fallback is done, but Soluling does fallback on the build process.

Localized element value that is written when there is no translation

Specifies what value to write into target elements when there is no translation. Possible values are:

Value Description Example
Empty value
Set the value of the target tuv element empty.
<tu>
  <tuv xml:lang="en"><seg>One</seg></tuv>
  <tuv xml:lang="de"><seg></seg></tuv>
</tu>
Original value Copy the original value into the value of the target tuv element.
<tu>
  <tuv xml:lang="en"><seg>One</seg></tuv>
  <tuv xml:lang="de"><seg>One</seg></tuv>
</tu>

This is visible only if Localized resources contain is set to All items.