9.7.5.2 Creating a list of ALink keywords from markers
Suppose you use a FrameMaker marker (for example, Subject) for ALink keywords. To capture ALink keywords from Subject markers, you can remap Subject markers to a new marker type AKey, and also clone the resulting AKey markers; see §29.3 Remapping marker types and hypertext commands:
When you remap a Subject marker with this assignment, both AKey and ALink markers get copies of the content of the Subject marker.
ALink is a predefined custom marker type; see §29.2.1 Identifying dedicated custom marker types. ALink marker content (inherited from the original Subject markers) is used for the ALink Name property of an HTML Help ALink object (not the button object, which you will construct with macros); see §7.6.4.1 Adding related-topic link keywords via markers.
AKey is an ad hoc custom marker type; AKey markers inherit the content of the original Subject markers. Assign AKey markers the Code property (see §29.4.1 Assigning properties to marker types):
Store marker content in a list variable
Assigning the Code property means that the content of each AKey marker (the ALink keyword inherited from a remapped Subject marker) can be wrapped in “before” and “after” code:
AKey=<$$Nkeys++><$$ALinkKeys[$$Nkeys]="
The “before” code does the following:
• Increments a counter, Nkeys (which will be initialized to zero before each topic).
• Uses Nkeys to index a list variable, $$ALinkKeys (see §28.4 Using multiple-value list variables).
• Provides an opening double quote for the content of the marker.
The “after” code closes the double quote after the content, and ends the list-variable assignment. The result is code that looks like this:
<$$Nkeys++><$$ALinkKeys[$$Nkeys]="keyword">
This code stores content taken from the original Subject marker in the Nkeys slot in list variable $$ALinkKeys.
As Mif2Go processes FrameMaker input for a topic, the $$ALinkKeys list gathers keywords from Subject markers until it is time to create the ALink button object for the topic, described in §9.7.5.4 Building an ALink button object from an ALink keyword list.
§9.7.5.3 Initializing the ALink keyword list counter
§9.7.5.4 Building an ALink button object from an ALink keyword list
§9.7.5.5 Positioning the ALink button in each HTML Help topic
> 9 Generating Microsoft HTML Help > 9.7 Creating related-topic links for HTML Help > 9.7.5 Using the same format or marker for ALink keywords and jumps > 9.7.5.2 Creating a list of ALink keywords from markers