Compiling for HtmlHelp
Previous Topic  Next Topic 

This screen compiles your help file into a .CHM file. The ".chm" extension is automatically added to your file name. The Title will appear on the top of your compiled help file.


Include Nonscroll/Header section

If this is checked then the Nonscroll region which you see at the top of the editor, will be included. The reason this is optional is because HtmlHelp does not inherently support Nonscroll regions in HtmlHelp. Fast-Help adds this feature by use of JavaScript to create a very effective visual impact.


Add Browse Buttons

If checked, the images specified in HtmlHelp Compiler Options for the browse images will be added to the top right of the Nonscroll region so that your user can navigate to the next and previous topics within each section.


Convert Unicode to Ansi

When you compile your CHM file with Unicode text, that text is visible to anyone who has unicode support on their computer. Currently that is anyone with Win2000 or greater. Unicode is a little ahead of its time but the world is slowly catching up. So if you are not sure if your users support unicode and you use Eastern/Asian characters that require unicode, you can check this option and your text will be converted to its Ansi equivalent. That means that you won't be able to read it correctly on your computer, but when viewed by the user in their own language they will be able to see it correctly.


Use International Character Set

This is an enhancement to the "Convert Unicode to Ansi" option. If these options are both checked then all text will be converted based upon the character set that is defined in either "Project | HtmlHelp Compiler Options", or if it is a Translation being compiled, then the Character Set for that Translation is used. If you use unicode then you never need to worry about this, but if some of your users do not have unicode enabled systems then this option can be very useful.


Automatically Sort the Index

When you add a new Topic a Keyword is automatically added to the Index tab. It is not sorted though, so it will initially appear at the top. If you check this option it is like clicking on the "Sort Index Alphabetically" button on the Index tab.


Quick Compile

When checked each Topic is checked to see if there have been any changes since it was last compiled and only changes are processed. The very first time you compile you will not see the benefit, but each subsequent time you will see dramatic speed increases.


Convert BMPs to JPGs

A "BMP" file is a bitmap graphic. These files are uncompressed and can take up a lot of space and cause the size of your CHM file to grow considerably. When you check this option, your BMP files will be converted to a compressed graphic file type called JPG. There may be a slight loss of quality, but a large gain in reduced file size.


AutoLink

When this option is checked, the compiler will use a series of rules to automically create links from certain words and phrases in your text. You can see more information on how AutoLinking works by clicking on this link.


Display CHM file after compiling

This option is checked by default. After you have compiled, if this option is checked, your new CHM file will be displayed.


Display the CHM file from the copied folder?

If the above option is checked and you have copied your CHM file to a different folder, then you have the option of displaying the CHM file from the folder it was copied to. By default the CHM file is stored in the "HtmlHelp" subfolder of your project. But if you have copied it to another folder, then you may want to test the CHM file that is in the copied to folder.


Copy Compiled Help Files To...

If you click the Right arrow you will see more options allowing you to select a destination folder and showing you what files will be copied. If you check this option then after compile, your help files will be copied to the specified folder.


Although there are very few options on this screen you can click on the Options button at the bottom of the screen to see more HtmlHelp specific options.


Click [OK] to begin compiling your help file. It will automatically be displayed when complete.