Most topics have entries in the Table of Contents (TOC). However, sometimes you also need topics that are not included in the TOC. For example, topic files without TOC entries are required for popup topics, and they are recommended for topics that are displayed in external windows in HTML Help. You can also use them for topics that are only displayed when the user clicks on a link.
To create a topic file without a TOC entry you just create the file in the Topic Files section of the Project Explorer instead of in the Table of Contents section.
1.In the Project Explorer open the Project Files > Topic Files section.
2.Select Add File > Add New File in Project > Manage Topics.
3.Enter the name of the topic you want to create. You can create multiple files by entering multiple names, one on each line.
4.Click on More Options and select a folder in Create in: to create the topic file in a sub-folder that you have created in the Topic Files section.
5.Select any other relevant settings for the topic.
You can create sub-folders in the Topic Files section to organize your files. It is a good idea to use separate folders for the various different types of topics files that are not included in the TOC to keep them separate from your TOC topic files.
1.Open the Topic Files section in the Project Explorer and select the folder that you want to add a new sub-folder to.
2.Select Add File > Add New Folder in Project > Manage Topics and enter a name for the new folder.
When you create new topics you can then click on More Options and select Create in: to create the topic file for the new topic in a specific folder.
You can apply both topic status and include options to topic files in the Project Files section of the Project Explorer. Just right-click on the file in the Explorer and select the options in the context menu, or select the options in the Change menu in Project > Manage Topics.
Sometimes you may decide that you would like to add a TOC entry to a topic file that does not yet have one. Or you want to add an additional TOC entry for a topic that already has one. You can do this with the TOC Link option in the New Topic dialog.
Method 1: Dragging topic files into the TOC
Dragging a topic file into the TOC from the Topic Files section will also create a new TOC entry for that topic file. It doesn't move anything. It just creates a new TOC entry. You can also do this with multiple files. Use SHIFT+Click and CTRL+Click to select multiple files, then drag them into the TOC.
Method 2: Creating a new TOC entry as a copy of an existing entry
You can also create a new TOC entry for a topic that already has a TOC entry by holding down the SHIFT+CTRL keys and dragging the original TOC entry with the mouse to the position where you want to insert the copy. Instead of moving the original entry this will then create a new TOC entry pointing to the same topic. This only works for topics that already have TOC entries, of course.
Method 3: Use the TOC Link tool
The TOC Link tool in the Insert New Topic dialog creates a new TOC entry for a topic file. Note that topics can have more than on entry in the TOC, because TOC entries are really just links pointing to topic files. They are not part of the topic.
Tip – locating the topic ID:
1.Click in the TOC where you want to insert the new entry and select the Add Topic tool in Project > Manage Topics.
2.Select TOC Link on the left and click on Link to Topic in this Project.
3.Select the topic ID of the topic you want to link to in the Target Topic: list. You can optionally also select an anchor to scroll to in the Topic Anchor: field if the target topic contains anchors.
4.Click on OK to insert the link.
See Multiple TOC entries for one topic for more details on this subject.