Creating Related Topics in Word
Related topics provide a list of other topics that may be of interest to the user viewing the current topic. For example, you could have a section called Creating Web Pages in your help. You may also have many other topics, such as HTML Tags and Cascading Style Sheets, that related to creating Web pages. Identifying these related topics for users can help them find the information they need and identify additional topics to consider. However, providing these types of links as cross-references within the content itself may not be the most efficient way to present the information. By utilizing related topics links, you combine the capabilities of cross-references with the efficiency of a related topics button.
Related topics and See Also links provide similar capabilities, but there are several important differences:
Related topics can link to headings in a Help system that do not start a new page.
Relate topics links are static and defined in the source documents as links. You must have all the source documents to create the link and generate the output.
If a related topics list contains a broken link in the source document, that link is broken in the generated output. In a See Also link list, the broken link is not included in the output.
The Stationery designer can configure related topics to display in the following ways:
Included as a list in the topic itself.
Displayed in a popup window when the user clicks a button, as show in the following figure.
Note: If a related topic link is broken in the source document, in most cases that link is broken in the generated output. WebWorks Help provides an additional feature by removing broken links from related topics lists that are displayed in a popup window when a user clicks the Related Topics button.
To create related topics links, your Stationery and template must have a Related Topics paragraph style configured. Your output format must also support this feature. For more information about output formats that support this feature, see “Features Available in Each Output Format” on page 9.
The following procedure provides an example of how to create related topics links in Microsoft Word source documents using Microsoft Word 2003. Steps for creating related topics links in Microsoft Word may be different in other versions of Microsoft Word.
To create a related topics list in a Microsoft Word source document
Identify the topic in which you would like to insert a related topics list.
Identify the different topics you want to link to from this topic.
Note: Generally, you should only create one related topics list for each section of your source document that corresponds to a help topic. For example, if the Stationery designer specified in your Stationery that there will be a page break at each Heading 1 section, then you should only create one related topics list for each Heading 1 section within your source document.
Create a cross-reference to each topic you want to include in the related topics list by completing the following steps:
Insert your cursor in the location in your Microsoft Word source document where you want to insert the link to the related topic.
On the Insert menu, click Reference > Cross-reference.
In the Reference type field, select Heading.
In the Insert reference to field, click Heading text.
Select the insert as hyperlink checkbooks.
In the For which heading field, select the heading to which you want to cross reference.
Apply the Related Topic paragraph style to the cross-references in your related topics list.
If you want to display the list of related topics in only your generated output, apply an OnlineOnly condition to the list of related topics. For more information about applying conditions, refer to “Applying Conditions in Word” on page 219.
Save your Microsoft Word source document.
Generate output for your project. For more information, see “Generating Output” on page 313.
In Output Explorer, go to the page where you created the related topics list and verify that ePublisher created the related topics and that the related topics list displays the topics you specified. For more information, see “Viewing Output in Output Explorer” on page 318.