Tagging

Tagging is a feature where you specify what strings are localized and how they are localized. It is mostly used when localizing programming code that contains strings such as with HTML scripts and plain source code files. Tagging is also used to give resource file items extra information like maximing length of teh string and regular expression to parse string.

Tags usage

Specifies how tags are used when localizing. Possible values are:

Tags apply range

Specifies the range where tag is used. Possible values are:

There are three kind of tags. They are:

Information/Include tags

Information/include tag is used to pass string properties to the project. The syntax is

<comment><tag>[comment string|attribute]...
attribute=MaxChars=mc|MaxPixels=mp|Expression="expression"

where comment is the single line comment character (e.g. "//"), tag is a tag string (e.g. slz), mc is the maximum length of the translation in characters, mp is the maximum length of the translation is pixels, and expression is the combined string expression.

The following line has an include tag that makes Sisulizer to scan the string.:

str = "Hello world"; //slz

The following line has an information tag that contains a comment ("Clicking this button opens on-line help") and sets the maximum length to 300 pixels:

str = "Click Help to get more information"; //slz MaxPixels=300 Clicking this button opens on-line help

Following parts are enabled when the Tags usage is set to Localize all but excluded.

Exclude tags

If you want to disable localization of a string, add an exclude tag on the same line where the string is located. The syntax is

<comment><tag>

For example the following line contains SQL statement and it should not be localized. To disable its localization an exclude tag has been added:

str = "SELECT * FROM MyTable"; //noslz

Block exclude tags

You can disable localization of a entire source code block by using begin and end exclude tags. These will disable all lines between these two tags. The syntax is

<comment><begintag>
<ignoreline>
...
<comment><endtag>

For example the string in the following two lines are not localized.

//beginnoslz
str1 = "Do not localize this"; 
str2 = "Do not localize this either";
//endnoslz

Sources

Combines strings can be used in the following source types: