18.14.2 Synchronizing TOC references to slave CHM files

The method described in this section works only for slave CHM files that are never used as stand-alone Help files. A simpler way to ensure TOC synchronization is to set UseChmInLinks=Yes, as described in §18.6.2 Specifying href link syntax for HTML Help.

When you merge CHM files, to ensure that TOC entries for topics in a slave CHM file are synchronized, when you generate the slave .hhc file you can have DITA2Go prefix references with master-to-slave text for the value of the Local parameter:

[MSHtmlHelpOptions]
; ContentsLocalValuePrefix = text to put before file references in
;  .hhc, used in slave .chms that are used only with a master.chm,
;  not alone
ContentsLocalValuePrefix = master.chm::/slave.chm::/

For example, if the master is guide.chm and the slave is intro.chm, you would specify:

[MSHtmlHelpOptions]
ContentsLocalValuePrefix = guide.chm::/intro.chm::/

A reference in the slave TOC would then look like this:

<li> <object type="text/sitemap">
<param name="Name" value="Introduction">
<param name="Local" value="guide.chm::/intro.chm::/Introduction.htm">
</object>

Previous Topic:  18.14.1.3 Requiring DITA2Go to use paths for mapped DITA files

Next Topic:  18.14.3 Putting up with a binary index for merged CHM files

Parent Topic:  18.14 Mapping and merging CHM files

Sibling Topics:

18.14.1 Interlinking multiple CHM files

18.14.3 Putting up with a binary index for merged CHM files

18.14.4 Merging CHM files

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

Table of ContentsIndex