Checklist for managing merged CHMs using RoboHTML 2000
Download this project's source code
- Make sure there are no spaces in any filenames. This can lead to a
"File not found" error when the user clicks on a TOC item.
- Add the prefix $global_ to all window definitions to avoid
possible problems where jumps appear in a different window that the
present session is using. (e.g., $global_TriPane instead of TriPane.)
- In a context sensitive call, be sure to add the name of the CHM as
well as the topic filename. Even though the topic is "merged"
into the Master CHM's TOC, it still remains in a separate CHM. (The
following is from the HHW API help file.)
HWND hwnd = HtmlHelp( GetDesktopWindow(),
HH_DISPLAY_TOPIC, NULL) ;
- Alinks and Klinks work well except that you must make at least one
Alink Name in the Master CHM for this to work.
- If using HHCTRL.OCX version 1.3 or 1.31, it is necessary to add at
least one Index keyword to the Master CHM for the merged Index to show up
in the Master CHM.
- Improve consistency of appearance by creating a common Cascading Style
Sheet for all files.
- Decide whether you want the merged elements to appear if a "sub-CHM"
is accessed independently. If you do, then in the [Merge Files] section of
the .HHP, all .CHMs should be listed, except that project's own .CHM.
- When using RoboHTML 2000, remember that your TOC's structure created in
the TOC Composer can be lost when you close and re-opening the project.
So, be sure to either backup the master file's .HHC, or make it "Read
- To get all Books on Level 1, open the Master file's .HHC in
Notepad and remove the closing </UL> tag in front of the last
</OBJECT> tag after the merged files listing. Then place that tag in
front of the beginning <OBJECT tag which starts the list of included
merged files. (Illustrated below.) As a precaution, make the .HHC
"Read only" as described above.
Much of the "Merging CHMs" material in this presentation was
created in response to questions from frustrated authors in such forums as
the Winhlp-L Listserve, Parametrica mailing list, the eHelp Community,
microsoft.public.helpauthoring newsgroup and websites throughout the help
authoring community. Among those offering valuable solutions were Robert
Chandler, Ralph Walden, Char James-Tanny, Cheri Lockett-Zubak, David Liske,
Don Lammers, Yuko Ishida, Neil Perlin, Matthew Brown, Diane Flewelling,
Brett Merkey, and Robert Cavicchio, Steve Wexler, Alicia Costello Sheldon
Siegel, Michael Müller-Hillebrand and Kate Pearson