18.6.1 Creating hypertext jumps to other CHM files

If you are using hypertext links to link to HTML files created from a different DITA document and compiled into a different .chm, you must specify how the CHM files are mapped; see §18.14.1 Interlinking multiple CHM files. Then DITA2Go can generate the proper jump reference for you.

Opening topic of first file

To jump to the opening topic of another CHM file, the simplest method is to insert a link in your document:

<xref href="someother.chm" scope="external"></xref>

If someother.chm is not registered in the Windows registry, also include the path, possibly relative. (For commercial use, it is best to register .chms in the Windows registry during installation.)

Opening topic of any file

To jump to a file that is within someother.chm, add the name of the target file to the link content; for example, to get to the “a” anchor inside letters.htm in someother.chm:

<xref href="someother.chm::/letters.htm#a" scope="external"></xref>

Specific topic

To jump to a specific topic in someother.chm, when the topic comes from a DITA file that is being split (so you do not know the .htm file name ahead of time), insert a regular DITA cross reference. Run the DITA2Go conversion to someother.chm first, then copy the .ref file for someother.chm into your conversion project directory, and add this setting to the configuration file:

[ChmFiles]
letters=someother

For links to non-CHM files, see §18.6.3 Linking to external files from compiled HTML Help.

Previous Topic:  18.6 Creating links and hypertext jumps in HTML Help

Next Topic:  18.6.2 Specifying href link syntax for HTML Help

Parent Topic:  18.6 Creating links and hypertext jumps in HTML Help

Sibling Topics:

18.6.2 Specifying href link syntax for HTML Help

18.6.3 Linking to external files from compiled HTML Help