Microsoft HTML Output - CHM

Notwithstanding its age, this format refuses to die. It is still popular where the help has to accessible offline and contained in a single file.

CHM files do not understand CSS3 standards so a copy of the css used is converted to CSS2 on the fly. This may mean the output is not exactly as designed.

Creating a CHM

Click the + icon in the Output Presets panel to create a new output and configure it as below.

The first time you generate an output from a project upgraded from a Classic version, you need to double click it or select Edit from the context menu and edit it as below.

After the preset is configured, use the icons above the list of presets or hover the mouse over a preset in the list to generate the output, publish it, make further edits or duplicate the preset.

The configuration options are similar to previous versions and are described in detail in the online help. Variables can be included in the Title. Place the cursor where you want the variable and press CTRL + 1.

Whilst you can create a Publish Location for this output, CHM files cannot be run from a server and this option should not be used for that purpose. Typically it will be used to deliver it to developers. How this is set up is described in Publishing.

Windows

To create or edit the window for Microsoft HTML Help (CHMs), click Outputs and select Window Settings.

Existing windows will be listed and you can create new ones by clicking the + icon.

Double click a window shown in the Project Component Panel to edit it or hover over it and click the menu icon that will be displayed.

You will then see the various settings that can be applied. Please refer to the Adobe RoboHelp online help for details.

If you also create other help outputs and your developers use an API with a window defined, settings for other outputs will be added later.

Generating the Output

Once you have defined the preset, click the generate icon.

Cancelling Generation

While an output is being generated, you can click the Cancel icon at any time.

Generation Errors

When you generate an output using Quick Generate, if it fails for any reason click the Error icon to access the log.

If you generated directly from the preset, you will get an error message. Right click the preset and click View Log.