Project Wizard - XML file

Use this sheet to specify how the selected XML file is localized.

Tags

Use this sheet to specify what elements should be localized in the selected XML file. Double click an element that you want to localize. To change the way how element data is interpreted right click the element and choose the right format.

Click Check all to check all the elements. Click Uncheck all to clear all selections. Click Edit to edit the selected tag. Click Show file to open the file in default viewer. Click Export to export selections to a file. Click Import to import selections from a file.

Read more about XML localization.

Output files

Specifies what kind of output file(s) are created. Possible choices are:

Options

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

Entities to be processed

Specifies how XML entities are processed. Sisulizer always decodes predefined XML entities when reading an XML file. The following table contains the predefined entities:

Sisulizer always decodes any hex or integer entity. For example if the XML file contains * it will be read as "*".

When creating localized XML file Sisulizer always encodes & and <. Encoding of other predefined entities depends on their usage in the original file. If the original file has encoded them then the localized files created by Sisulizer use the same encoding. If the original uses several encoding methods Sisulizer prefers name encoding over hex and integer encoding, and hex encoding over integer encoding.

If original XML files contains hex or integer encoding that do not belong to the above predefined entities Sisulizer does never use any encoding when writing characters to the localized XML file. Plain character is written instead.

String entities

If String entities is checked Sisulizer decodes custom string entities when reading the XML file and encodes them when writing the XML file. A custom string entity is a entity defined either in DOCTYPE element or in the DTD file.

<!ENTITY sportname "Downhill skiing">

Whenever an XML element contains &sportname; it will be expanded to Downhill skiing. For example:

<sample>&sportname; is very fast sport.</sample>

will be expanded to "Downhill skiing is very fast sport".

If String entities is unchecked Sisulizer does not decode the string but leaves it as it is. For example the above sample will be read as "&sportname; is very fast sport".

When writing localized XML file Sisulizer does never use string entities but writes plain characters.

File entities

If File entities is checked Sisulizer decodes custom file entities when reading the XML file and encodes them when writing the XML file. A custom file entity is a file based entity defined either in DOCTYPE element or in the DTD file.

<!ENTITY vehicle SYSTEM "Sports.xml">

The content of Vehicle.xml is:

<?xml version="1.0" encoding="UTF-8"?>
  <sport>Skiing</sport>
  <sport>Cycling</sport>

Whenever an XML element contains &sports; it will be expanded to content of Sports.xml file. For example:

<sample>&sports;</sample>

will be expanded to:

<sample>
  <sport>Skiing</sport>
  <sport>Cycling</sport>
</sample>

If File entities is unchecked Sisulizer does not decode the string but leaves it as it is. For example the above sample will be read as will be read as "&sports;".

When writing localized XML file Sisulizer does never use file entities but writes plain characters.

Segmentation

Specifies if segmentation is used. More information about segmentation is found from XML Source Dialog.