Normally you only have one item in the Table of contents (TOC) for each topic file. However, there may be some situations where you want to use exactly the same topic in more than one place in the TOC.
You can do this by creating multiple references to an single topic in the TOC. The result is a single TOC topic that can be accessed from multiple positions in the TOC. There is still only one topic, but it is displayed in several different positions within the TOC – for example in different chapters.
Sometimes it is better to create a copy or to use an embedded topic. See Snippets and multiple TOC references for more background information.
Key Information
Multiple TOC references are not copies of topics. There is still just one topic file but with two items pointing to it in the TOC. It is like a single room with two doors.
|
1.Click in the TOC in the position where you want to enter the new TOC item, then select any of the options for creating a new topic.
2.When the Insert Topic dialog is displayed select TOC Link on the left. Then select Link to topic in this project.
3.Enter a title for the new TOC link in Heading in Table of Contents:, then select the ID of the topic you want to link to from the Target Topic: list. You can also select an anchor to scroll to if the topic contains anchors.
4.Click on to create the new TOC link. |
1.Click on the topic you want to make an additional reference to in the TOC to select it.
2.Hold down Shift+Ctrl and drag to the position where you want to create the second reference. Dragging onto a topic makes the new reference a child (sub-topic) of the target topic. Dragging between two topics (position mouse to left of topic icons) inserts the reference between the target topics. (See Moving, cutting and pasting topics.)
Warning for Parallels users on Apple Mac computers:
If you are running Windows in Parallels on an Apple Mac computer this will not work initially. This is because by default Parallels maps the right mouse button to Shift+Ctrl+Left Click. You need to re-map this key combination in the Parallels settings to be able to create additional TOC references with Drag & Drop.
|
PDF is a special case because only topics with TOC entries can be included in PDF documents. If your project contains "invisible" topics that are normally only displayed with hyperlinks from other topics you must add TOC entries for them to be able to include them in the PDF version of your output. This is very simple to do with the knowledge you now have:
1.Create TOC entries for the "invisible" topics: Either drag the topic file into the TOC or create a "new" topic and select the topic ID of the invisible topic with the browse button in the Topic ID: field of the new topic dialog. You might want to organize these TOC entries as one or more special chapters in your TOC.
2.Apply build options to the new TOC entries so that they are only included in the PDF version of your output. See See Including and excluding TOC entries above for instructions. |
See also:
Using embedded topics
Moving, cutting and pasting topics