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.
Specifies how tags are used when localizing. Possible values are:
|Localize all but excluded||Sisulizer localizes all strings except those that have an exclude tag. You can also use information/include tags to give some properties such as comments and maximum lengths.|
|Localize only included||Sisulizer localizes only those strings that have an include tag.|
Specifies the range where tag is used. Possible values are:
|To all strings in the line
||The tag is applied to all strings in the line where tag is.|
|Only the string following the tag||The tag is applied only to the next strings following the tag.tag.|
There are three kind of tags. They are:
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.
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
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
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
For example the string in the following two lines are not localized.
str1 = "Do not localize this";
str2 = "Do not localize this either";
Combines strings can be used in the following source types:
|Platform||Description||Sample that demonstrates how to use combined strings|
|HTML||String values in scripts||<sldir>\Text\Ini\Combined.*|
|Source code||String values||<sldir>\Source\Pascal.*|