8.8.7 Comparing HHW settings for stand-alone vs. merged CHMs

You might have to experiment with HTML Help Workshop settings to achieve the best combination of functionality and features for your particular project organization and content. HTML Help appears to be "surprisingly complex and not overly predictable".

For example, a binary TOC is not usually compatible with merged CHM files. However, see:

http://msdn.microsoft.com/en-us/library/aa814522(VS.85).aspx

Here is the rationale for certain combinations of settings for the following CHM roles:

Stand-alone CHM files	[OPTIONS]Binary index=No (for "better index disambiguation")
	[OPTIONS]Binary TOC=Yes (required for native HTML Help browse navigation; see §8.3.3 Adding tabs and toolbar buttons to HTML Help)
	Options Files tab: remove .hhk file (to synchronize the TOC with the index when Binary TOC is enabled)
	Window Types Buttons tab: check Prev and Next (for native HTML Help browse navigation)
Slave CHM files in a merged HTML Help project	[OPTIONS]Binary index=Yes (required for merged files)
	[OPTIONS]Binary TOC=No (not compatible with merged files; however, you might successfully merge slaves that have Binary TOCs, if you sacrifice correct native browse navigation)
	Options Files tab: retain .hhk file (or the indexes will not merge)
	Window Types Buttons tab: clear Prev and Next check boxes (native HTML Help browse navigation does not function correctly in merged files)
Master CHM file in a merged HTML Help project	[OPTIONS]Binary index=Yes (required for merged files)
	[OPTIONS]Binary TOC=No (or the TOC of the merged project will be a mess)
	Options Files tab: retain .hhk file (or the index will not merge)
	Window Types Buttons tab: clear Prev and Next check boxes (native HTML Help browse navigation does not function correctly in merged files)

Table 8-3 summarizes the settings that should work for stand-alone HTML Help projects and for merged projects.

Table 8-3 HTML Help Workshop settings for stand-alone vs. merged CHMs

CHM file(s)	[OPTIONS] Binary TOC=	[OPTIONS] Binary Index=	*Options: Files tab, Index*	*Window Types: Buttons tab*
Stand-alone CHM:	Yes	No	Remove .hhk	Check Prev and Next
Merged CHMs:	No	Yes	Retain .hhk	Clear Prev and Next

See also:

§8.12.3 Merging CHM files

http://www.helpware.net/htmlhelp/how_to_merge.htm

http://www.helpware.net/FAR/help/dlg_hhpedit_sec.htm

http://www.help-info.de/de/FAR/dlg_hhpedit.htm

> 8 Generating Microsoft HTML Help > 8.8 Generating contents and index for HTML Help > 8.8.7 Comparing HHW settings for stand-alone vs. merged CHMs

8.8.6 Making the TOC track index links in HTML Help

8.8.8 Customizing contents and index for HTML Help