### 13.5 Generating associative links for Help output

To generate associative links (see §16.6.2 Understanding how ALinks work) for topics associated by related-links or by reltables:

    [RelatedLinks]
    ; GenerateALinks = No (default) or Yes (generate ALinks for topics
    ; associated by related-links items or by reltables)
    GenerateALinks = Yes

In a reltable, each row is associated with an ALink name that is applied to all local topics within the row. And each related-links section is also associated with an ALink name.

In either case, you specify the name as the id attribute of the relrow or the related-links element. such IDs need to be unique only within their topic or map file, not in the whole project. So you can use the same term for rows in different maps, and in different topics, to identify the ALink groups. DITA2Go automatically eliminate any duplicates.

If a relrow, or a related-links element, has no id attribute, DITA2Go skips that row or element. The id attribute can have only one value, not a list of values, so you have to live with that limitation when you direct DITA2Go to generate ALinks from related-links or reltables.

For Help output, there are other ways to specify ALinks, by inserting ALink and ALinkJump PI markers in your DITA XML files; see §16.6 Providing related-topic links for Help systems. You should choose between allowing DITA2Go to generate ALinks and inserting them yourself with PI markers. Do not try to mix the two methods.

Previous Topic: 13.4 Including descriptions with related links

Next Topic: 13.6 Formatting links in output

Parent Topic: 13. Processing related and associative links

Sibling Topics:

13.1 Understanding how DITA2Go treats reltables

13.2 Generating and including related links

13.3 Appending links to topics

13.4 Including descriptions with related links

13.6 Formatting links in output

13.7 Changing link path for peer related links