Project Wizard - HTML Help file

Use this sheet configure how help file is localized.

HTML Options

Specifies how HTML data is localized. Possible values are:

HTML Help Options

Specifies HTML Help options and what other HTML Help items in addition of HTML data is localized. Possible values are:

Contents Sorting

Specifies if the table of contents (TOC) will be sorted. Possible sorting methods are:

Top level sorting specifies how top level items in the contents are sorted. Sub level sorting specifies how sub level items are sorted.

Note! When you turn on sorting Sisulizer visual contents editor still shows the contents as unsorted. However when you build localized files the contents is sorted using the sort method you selected.

Place pages into first letter based folders

If checked table of contents is sorted alphabetically. This means that if original file contains a sub folder having single character as its name all the sub pages will be placed on sub folders where the name of the folder matched the first characters of the page name.

Note! This option is used only when you localize to a language that uses alphabets. If you have Chinese, Korean or Japanese in your project the contents file this options is ignored for those languages.

Samples

The following image contain original non sorted table of contents.

The following image contain sorted table of contents where Sort pages first, then sub folders sorting is used.

The following image contain sorted table of contents where Sort pages and sub folders together sorting is used.

The following image contain original non sorted table of contents that contains alphabet based sub folders. The name of the each sub folder is only one character. Each sub folder contains pages that start with the same name as the folder name.

The following image contain Finnish version of above table of contents.

You can see that there are now four sub folders instead of original three. This is because in Finnish all three vehicles start with different letter. In English both bike and bicycle start with b.

Tags

Use this sheet to control what strings are scanned from the files and how they are scanned. Tags are used to control the scan process. They are single line comments that contain information for Sisulizer scanner.

Tags usage

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

There are two 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