Runtime Merging Output From HTML Help Projects (CHM Files)

Use this merging method if you are developing Microsoft HTML Help (a CHM file) and you want to merge your output with another CHM file. This method is useful, for example, if another author is working on the external Microsoft HTML Help project to which you are linking and you only have access to the other CHM file (not the project files).

You can merge your output with another CHM file that you have already brought into your project (perhaps via the external resources feature—see External Resources), or you can select a CHM file located elsewhere, in which case a copy of it is added to your project.

How to Merge Output From HTML Help Projects

1. Open the TOC in the Flare project that will serve as the parent project.

   Note You can also merge projects by linking them from a browse sequence, as well as from a TOC. If you want to do this, simply follow these same steps after opening your browse sequence.

2. Do one of the following:

   • In the TOC Editor, select the TOC entry or book where you want to link the output from the child HTML Help project. (The TOC of the linked CHM file will be inserted at that spot in the parent TOC.)

     OR

   • If the CHM file already exists somewhere in your project, you can open the Content Explorer and drag the CHM file to the location in the parent TOC where you want to place it. If you use this method, the link will not point to any particular topic in the CHM file. Also, if you use this method, you do not need to complete the rest of the steps below.
3. In the local toolbar of the TOC Editor, click . The Properties dialog opens.
4. On the General tab, click Select HTML Help. The Link to HTML Help dialog opens.
5. Do one of the following:

   • If the child CHM file is already in your project Select Project Files and then use the area below to navigate to the file that you want to link to and select it. By using the buttons in the local toolbar, you can view all files in a list, view files in their folder structure, and use other options.

     Option	Description
     	Shows or hides the folders that the files are stored in.
     	Shows or hides the files. If you click this button when the Show Folders button is selected, the area splits into two. The folder is shown on the left side, and the files and subfolders within it are shown on the right.

   • If the child CHM file is not yet in your project Select Import Existing. In the dialog that opens, find and double-click the child CHM file. Then from the drop-down—which displays "(root folder)" by default, you can select a specific content folder in your project to place the child CHM file.

6. (Optional) If you want to point to a specific topic in the child CHM file, in the Topic field click . In the dialog that opens, find and double-click the topic that you want to link to.

   If you use this option, only the specified topic will be included in the TOC, as opposed to the entire TOC of the child CHM. However, even though just one topic will be included in the merged TOC, the other topics in it will still be included in the output and you can get to them through other means (e.g., clicking hyperlinks).

7. Click OK in the Link to HTML Help dialog.
8. If you imported a child CHM file, the Copy to Project dialog opens. You can select Keep file synchronized (create mapping). This creates a link (map) between the original file and the copy being added to your project (see Copying and Mapping External Resource Files). Then click OK in the Copy to Project dialog.
9. (Optional) If you want the merged TOC to replace the entry that you selected, do the following.
   1. Select the Advanced tab.
   2. Click the check box labeled When merging, replace node with merged TOC.

   For example, you might have a TOC in your parent project that looks like this:

   

   If you select the option in this step to replace the node, the merged TOC would look like this in the output:

   

   And if you do not select this option, your merged TOC would look like this:

   

10. In the Properties dialog, click OK.