The first button in the toolbar creates the most common type of link, called a Topic Link or Jump Link. Some text is highlighted in the document, and when the user clicks it, a different topic appears.

Let's add a few jump links to our project.

1.   In the Doc-To-Help project editor, double-click the Equipment document to open it in FrontPage.

2.   Scroll down the document until you see the table that contains equipment prices.

3.   Double-click the first item, Mask, to select it, and click the Jump Link button  in the toolbar. The Topic Link dialog box opens.

4.   Click the Browse button  next to the Topic text box to see a list of available topics.

5.   Select the topic Masks from the topic list and click OK.

6.   Click OK to close the dialog box.

7.   Save the document.

8.   Repeat the process to add links to the other topics on the table (except Booties & gloves, which doesn't have a separate topic).

Before you rebuild the project, take a look at the HTML source code for the links. The Masks link we just added should look like this:

D2HML syntax: Adding Topic Links

<span class="C1HJump"><b>Mask</b>
<span style="display:none">|tag=Masks</span></span>

The button added a <span> tag around the link text and a hidden <span> that contains the name of the target topic. This is simple plain HTML. Doc-to-Help will turn this into a link when it builds the help project.

If you want to test the links, this is a good time to rebuild the project and try them out.

Note: After adding hyperlinks, it is good practice to rebuild the project and check the Errors and Unresolved Links lists in the Doc-to-Help Build tab.

Picking topics from a list reduces the chances of mistakes, but eventually you may change some topics names and that could break a few links.