Related topics

Related topics in OmniHelp are the same as those implemented in WinHelp and HTML Help using ALinks to associate items having the same subject matter. Related topics also provide a way to manage links to subprojects—when the target topics might or might not be present—without risking a broken link if the topic is indeed missing. In OmniHelp, ALinks are treated as first-class navigational aids, just like Contents, Index, and Search. There is no need to add “Related Topics” links and buttons, and navigate through dialogs, to use this feature in OmniHelp. When the Related navigation tab is selected, the navigation pane shows as links the titles of all topics that share any of the ALink references in the current topic. This display stays in sync with the current topic. The upper part of the pane shows the actual ALink terms. However, since ALink terms are not shown in other systems, and might even prove embarrassing, their display may be turned off in OmniHelp by an .ohx setting, relShowSubjects.

OmniHelp also supports ALink jumps and KLink jumps, like those used in WinHelp and in HTML Help. (JavaHelp does not support ALinks or KLinks, and Oracle Help for Java supports ALink jumps only.) With Mif2Go, the link is specified with an alink: or klink: protocol; in the OmniHelp, this protocol becomes a call to javascript:alink(...) or klink(...) where the parameter is the standard set of one or more semicolon-delimited identifiers. When a user clicks an ALink or KLink jump in a topic, with the Related tab selected in the navigation-control pane, the navigation pane shows a list of links to the relevant topics, sorted in Contents order.