## Table of Contents Page

### About This Page

This page allows you to edit the structure and properties of tables of contents.

You can modify and visualize the structure and order of elements in a table of contents using the Table of Contents section. This section occupies the left-hand portion of the editor area.

You can modify the properties of specific elements in the Table of Contents by using the corresponding Details sections. These sections appear in the right-hand portion of the editor area depending on the type of element selected in the Table of Contents section.

### Page Sections

This page is comprised of the following sections:

- Table of Contents Section
- Book Details Section
- Topic Details Section
- Link Details Section
- Anchor Details Section

### Table of Contents Section

This section allows you to do the following:

- Visualize and modify the structure of a table of contents via addition, removal and reorganization of its elements.
- Activate the corresponding Details section used to edit the properties of a specific element in the table of contents.
- Find and open existing documentation pages and tables of contents linked from this table of contents.

### Table of Contents Section Fields

The table of contents tree viewer field displays the structure of the table of contents as it will appear in the Help system. This tree viewer allows you to modify the structure of the table of contents by reorganizing existing elements or adding new ones to the tree.

This viewer contains the following kinds of elements:

- The book element is the root element of a table of contents. Select this element to activate the Book Details section.
- Topics serve as links to Help files, as well as containers for other elements in the table of contents. Select a topic to activate the Topic Details section.
- Links allow you to include elements from other tables of contents in your table of contents. Select a link to activate the Link Details section.
- Anchors allow other tables of contents to specify that their elements will appear in your table of contents. Select an anchor to activate the Anchor Details section.

### Table of Contents Section Actions

Click on the Add Topic, Add Link or Add Anchor buttons in order to add a new topic, link or anchor to the table of contents. These actions are available when any element is selected. If the selected element is a book or topic element, the new element will appear as the last child of the selected element. Otherwise, the element will appear immediately after the selected element.

You can also create topic elements by dragging HTML files and dropping them on the desired location within your table of contents. The newly added topic directs the user to the dropped page.

Similarly, you can create link elements by dragging XML files representing tables of contents and dropping them on the desired location within your table of contents. The newly added link will reference the dropped table of contents.

Click the Remove button to remove an element from the table of contents. This action is available for all elements except the book element. Note that, in order to maintain the validity of a table of contents, a topic cannot be removed if it is the only direct child of the book element.

Click the Up button to move an element up one position with respect to its siblings. This action is available for all elements except the book element.

Click the Down button to move an element down one position with respect to its siblings. This action is available for all elements except the book element.

You may also move elements within a table of contents by dragging them and dropping them in the desired locations.

To open the documentation file specified by a table of contents or a topic, simply double-click on it. To reveal the documentation file in a resource view, simply right-click the element and select an option from the Show In submenu.

To open the table of contents specified by a link, simply double-click on the link. To reveal the table of contents in a resource view, simply right-click the link and select an option from the Show In submenu.

### Book Details Section

The Book Details section allows you to edit the name, page location and anchor path of this table of contents.

### Book Details Section Fields

Edit the Name field to specify the name of the book.

Edit the Location field to specify the location of a page associated with the book. This page will appear when the user clicks on the book element in the Help Contents window. If no page is specified, a default Help page is automatically generated by the Help system at runtime.

The Anchor field allows you to specify if this table of contents will be embedded within another table of contents. The anchor field takes the path to a table of contents and the ID of an anchor contained in that table of contents, separated by a '#' symbol. When users view the referenced table of contents in the Help Contents window, the contents of this table will be displayed at the location of the specified anchor.

### Book Details Section Actions

If the path specified in the Location field refers to an existing HTML page, then clicking on the Location hyperlink will open the page in a default editor. If the path refers to a file that does not exist, or if the path is empty, then clicking on the Location hyperlink opens a New Page Wizard, which allows you to create HTML pages. In the wizard, the File name field is automatically populated with the file name from the Location field (if specified). If a valid folder path is specified in the Location field, then this path is automatically selected in the wizard as the location of the new file.

Click the Browse button to open the Page Selection dialog, which allows you to select an existing HTML page. The dialog presents a hierarchical view of HTML pages contained within your workspace. After a selection is made, the relative path from the project that contains the table of contents to the selected HTML page is automatically entered into the Location field.

### Topic Details Section

The Topic Details section allows you to edit the name and page location of this topic.

### Topic Details Section Fields

Edit the Name field to specify the name of the topic.

Edit the Location field to specify the location of a page associated with the topic. This page will appear when the user clicks on the topic element in the Help Contents window. If no page is specified, a default Help page is automatically generated by the Help system at runtime.

### Topic Details Section Actions

If the path specified in the Location field refers to an existing HTML page, then clicking on the Location hyperlink will open the page in a default editor. If the path refers to a file that does not exist, or if the path is empty, then clicking on the Location hyperlink opens a New Page Wizard, which allows you to create HTML pages. In the wizard, the File name field is automatically populated with the file name from the Location field (if specified). If a valid folder path is specified in the Location field, then this path is automatically selected in the wizard as the location of the new file.

Click the Browse button to open the Page Selection dialog, which allows you to select an existing HTML page. The dialog presents a hierarchical view of HTML pages contained within your workspace. After a selection is made, the relative path from the project that contains the table of contents to the selected HTML page is automatically entered into the Location field.

### Link Details Section

The Link Details section allows you to edit the location of a linked table of contents file.

### Link Details Section Fields

Edit the Location field to specify the location of a table of contents file to link. The elements in the linked file will replace this link in the table of contents when the user views the table of contents in the Help Contents window.

### Link Details Section Actions

If the path specified in the Location field refers to an existing table of contents file, then clicking on the Location hyperlink will open the page in a default editor. If the path refers to a file that does not exist, or if the path is empty, then clicking on the Location hyperlink opens a New Table of Contents Wizard, which allows you to create a new table of contents. In the wizard, the File name field is automatically populated with the file name from the Location field (if specified). If a valid folder path is specified in the Location field, then this path is automatically selected in the wizard as the location of the new file.

Click the Browse button to open the Table of Contents Selection dialog, which allows you to select an existing table of contents. The dialog presents a hierarchical view of tables of contents contained within your workspace. After a selection is made, the relative path from the project to the selected table of contents is automatically entered into the Location field.

### Anchor Details Section

The Anchor Details section allows you to edit the identifier of this anchor.

### Anchor Details Section Fields

Edit the ID field to specify the identifier of the anchor.

### Relevant Links

- Table of Contents Editor
- New Table of Contents Wizard