Setting up hypertext links between topics
Hypertext links are created with the :link tag. When you use a link tag, the term that you associate with it is highlighted on your screen.
Before you establish a hypertext link, you need to know the id= value of the topic that you want to access.
The link tag has a matching end tag, and is coded as follows:
where
- xxxxx is the id= of the topic to which you want to hyperlink.
- term is the term that you want to highlight for that Help topic (such as its title).
Look again at the following Help topic:
:h1 id=ASGDMN.Domain
:p.
The Domain field identifies the SRM domain of the active
address space.
:p.
You can modify domain values by using the SET DMN
operator command.
:p.
The name of this element is ASGDMN.
Suppose that you decide to establish a hypertext link between this topic and the topic that addresses the SET DMN command. The id= attribute for the SET DMN command is setdmn; therefore, you add the link tag to the Help topic as shown in following figure.
.:h1 id=ASGDMN.Domain
:p.
The Domain field identifies the SRM domain of the active
address space.
:p.
You can modify domain values by using the
:link reftype=hd refid=setdmn.SET DMN:elink.
operator command.
:p.The name of this element is ASGDMN.
When you display this Help text on the screen, the link tag automatically displays the title, SET DMN, in bold or in reverse video (there is no need to enclose the term in :hp2. tags).
Hypertext links work just like hyperlinks. When you place the cursor on the highlighted term SET DMN and press Enter, Help on the SET DMN command is displayed.