Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

7 Producing on-line Help > 7.6 Providing related-topic links for Help systems > 7.6.3 Understanding how KLinks work


7.6.3 Understanding how KLinks work

Keyword links (KLinks) are based on index entries. When you are viewing a topic that contains a KLink jump, you can click the jump hotspot (or related-topics button) to display a list of links to all topics that are indexed on the keyword(s) specified in the jump.

The following Mif2Go-generated Help systems nominally support KLinks, though only for index entries that meet assorted restrictions:

HTML Help

OmniHelp

WinHelp 4

You insert in a topic a KLink jump that specifies the content of one or more entries in the index. When a user selects the KLink jump, all index entries with the same content, and with the same links as in the index, are displayed in a list.

Use KLinks only as a last resort

KLinks are high-maintenance items for documents where index entries are subject to change when the document is revised. An index term in a KLink jump must match exactly a term in the index itself; if the term is changed in the index, you must make the identical change in any KLink jump that references that index term, or the jump will not generate a link to the corresponding topic; and in some systems, it might yield an error message instead. Help-system implementation of KLinks is uneven. KLinks have proved to be problematic in all Mif2Go-generated Help systems where they are nominally supported.



7 Producing on-line Help > 7.6 Providing related-topic links for Help systems > 7.6.3 Understanding how KLinks work