Defining See Also Links
See Also links are associative links (Alinks) that identify other topics that may be of interest to the user of the current topic. These links use internal identifiers to define the links and the list is built dynamically based on the topics available when the user displays the links. See Also links are important to use with larger help sets and merged help sets.
Related topics and See Also links provide similar capabilities, but there are several important differences:
- See Also links must link to styles that start a new topic, such as a heading.
- See Also links are dynamic and the lists of links are built at display time instead of during help generation.
- Since See Also link lists are dynamically built, they do not include links to topics that are not available when the user displays the links. If a related topics list contains a broken link in the source document, that link is broken in the generated output for most output formats.
Enabling See Also Functionality
If you want to create a See Also link as inline text without a button, create a unique character style and select the See Also option for that style. If you want to use a button to display the See Also links, create a unique paragraph style, select the See Also option for that style, and type the See Also text on that paragraph. The properties you select for the paragraph style in Style Designer affect the text of the See Also button. To modify the appearance of the button itself, see Modifying the Appearance of the See Also Button. You also need to create a SeeAlsoLink and SeeAlsoKeyword marker.
HTML Help also supports the SeeAlsoLinkDisplayType and SeeAlsoLinkWindowType markers. These markers allow you to change how the See Also links are displayed in HTML Help. For example, you can display the links as a popup menu.
Note: If paragraph and marker styles are created in your source document after you create a project, scan the document in the project again for the changes to take effect.
To enable See Also functionality in your Stationery
- Open your Stationery design project.
- On the View menu, click Style Designer.
- On the Project menu, click a target in the Active Target menu option that is an output format that supports this option.
- If you want to use buttons for See Also links, complete the following steps:
- In Paragraph Styles, select the paragraph style to use for See Also links.
- On the Options tab, set See Also to Enabled.
- If you want to use inline text for See Also links, complete the following steps:
- In Character Styles, select the character style to use for See Also links.
- On the Options tab, set See Also to Enabled.
- In Marker Styles, select the SeeAlsoKeyword marker style.
- On the Options tab, set Marker type to See Also Keywords.
- In Marker Styles, select the SeeAlsoLink marker style.
- On the Options tab, set Marker type to See Also Link Keywords.
Modifying the Appearance of the See Also Button
The properties you select for the paragraph style in Style Designer affect the text of the See Also button. In some output formats, you can modify the color of the See Also button background and borders. You must separately modify each button border. You can also modify each of the See Also button colors.
Note: To change the color of the See Also button, you modify the
content.xsl file. If you modify the content.xsl file, you will be responsible for maintaining your customizations to the file as needed each time you update your Stationery to work with a new version of ePublisher.For more information about override files and locations, see Stationery, Projects, and Overrides.
To change the color of the See Also button
- If you want to override the processing for an output format, complete the following steps:
- In your Stationery design project, on the View menu, click Format Override Directory.
- Create the
Formats\<formattype>\Transformsfolder in your project folder, where formattype is the name of the output format you want to override, such as WebWorks Help 5.0.
- If you want to override the processing for a target, complete the following steps:
- In your Stationery design project, on the View menu, click Target Override Directory.
- Create the
Targets\<targetname>\Transformsfolder in your project folder, where targetname is the name of the target you want to override.
- Copy the
content.xslfile from the following folder to the override folder you created within your project folder:Program Files\WebWorks\ePublisher Designer\Formats\<formattype>\Transforms - Open the
content.xslfile you copied to your project override folder. - Find the following code section.
<html:table border="0" cellspacing="0" cellpadding="0" onclick="{$VarCargo/wwalinks:ALink[1]/@onClick}" summary="">` <html:tr> <html:td height="2" colspan="4" bgcolor="#FFFFFF"></html:td> <html:td width="2" height="2" background="{$Var_seertup}"></html:td> </html:tr> <html:tr> <html:td width="2" height="2" bgcolor="#FFFFFF"></html:td> <html:td height="2" colspan="3" bgcolor="#EEEEEE"></html:td> <html:td width="2" height="2" background="{$Var_seeright}"></html:td> </html:tr> . . . - Modify the RGB color values in the bgcolor attributes within this table to adjust the colors of the margins that form parts of the See Also button.
- Save the
content.xslfile. - Regenerate your project to review the changes.
Last modified date: 01/28/2026