You are here: Doc-To-Help Markup Language (D2HML) > Hot Spot Types > Keyword Link Hot Spot

Keyword Link Hot Spot

The Keyword Link hot spot creates a link to the topics associated with the keyword contained in the hot spot or the specified keyword. A topic must be associated with the keyword before this hot spot can link to it. For example, you can create a link to the topics associated with the keyword MyKeyword. To associate a topic with a keyword, see Keyword and Invisible Keyword Hot Spots.

The Behavior property of this hot spot type is set to Keyword Link. The following predefined styles have this Behavior, and the corresponding HTML tag or Word Style can be used when formatting without the D2HML Styles toolbar:

D2HML Style

Corresponding HTML Tag

Corresponding Word Style

C1H Keyword Link (Hidden=False)

<span class="C1HKeywordLink"></span>

C1H Keyword Link

 

The following properties are supported by this hot spot type:

Supported Properties:

Description

Keyword

This is one or more keywords defining the list of topics shown to the user as link targets. The characteristics of this property are:

      Primary

      Default

      Collection

      Case-insensitive

Window

This is the name of the window displaying the topic after the user selected the target from the list. The characteristics of this property are:

      Secondary

      Case-insensitive

DisplayAsButton

This property specifies whether the hot spot is represented by a button in help targets. The characteristics of this property are:

      Secondary

      Boolean value
True or False

      Case-insensitive

      Default value: False

To create a Keyword Link hot spot, select the link text and press Keyword Link  on the D2HML Styles toolbar. Use the Keyword Link dialog box to specify the properties of the link.

Keyword Link Dialog Box

Click the More button  to access additional properties. When the More button is clicked while using this dialog box in Word, you may select the Hide Properties in Document checkbox to hide the properties in your source document. To show the properties, uncheck the Hide Properties in Document checkbox, or select Tools | Options in Word and on the View tab, check the Hidden text checkbox.

Note: When the More button is clicked while using this dialog box in FrontPage and Dreamweaver, there is a Display as a button checkbox, not a Hide Properties in Document checkbox. When this checkbox is selected and the help target is built, the link appears as a button rather than a link.

If you are not using the toolbar, place the link text and secondary part in the corresponding HTML <Span> tag to format it with the D2HML style.

The following table gives you some examples of using the Keyword Link hot spot:

Hot Spot in Word and HTML Editor

HTML Code

Description

MyTopic

<span class="C1HKeywordLink">MyTopic</span>

A link to the topics associated with the keyword MyTopic is created.

MyTopic|window=proc

<span class="C1HKeywordLink">MyTopic|window=proc</span>

A link to the topics associated with the keyword MyTopic is created. The topic selected by the user is shown in the window with the name proc.

Text|keyword=Keyword;window=proc

<span class="C1HKeywordLink">Text|keyword=Keyword;window=proc</span>

A link to the topics associated with the keyword Keyword is created. The topic selected by the user is shown in the window with the name proc.

Text|keyword=Keyword1+Keyword2

<span class="C1HKeywordLink">Text|keyword=Keyword1+Keyword2</span>

A link to the topics associated with keyword Keyword1 or Keyword2 is created.

Text|=Keyword1+Keyword2

<span class="C1HKeywordLink">Text|=Keyword1+Keyword2</span>

A link to the topics associated with keyword Keyword1 or Keyword2 is created.

Text|keyword=Keyword1+Keyword 2,Secondary keyword

<span class="C1HKeywordLink">Text|keyword=Keyword1+Keyword 2,Secondary keyword</span>

A link to the topics associated with keyword Keyword1 or with the second-level keyword Secondary keyword nested in the keyword Keyword1 is created.