Adding documents to the help system

Targeting frames in SCOhelp

The SCOhelp browser interface includes two frames that display the HTML content and two frames that provide navigational buttons (an additional browser window for popup information is also available):

navlist
the left frame generally used to display a list of references, such as a table of contents, whose links appear in the right frame

node
the right frame generally used to display the body of the information; all content appears in this frame or in a popup window

navbar
the toolbar below the left navigational frame

nodebar
the toolbar below the right frame

popup
a separate window available for placing sidebar information, such as code examples or annotations, large tables, figures, or tangential information
Use these frame names in the TARGET attribute in an HTML link to place the content in a particular frame:
   <A HREF="/topicID/topic.html" TARGET="node">
To specify the default target for all the links in the current document, use the <BASE> element:
   <BASE TARGET="node">

Tables of contents targets

In general, the TARGET for links to a table of contents file or other navigational list should be the navlist (left) frame. For example:

<A HREF="/DSK_scohelp/CONTENTS.html" TARGET="navlist">Using SCOhelp</A>
Links from the table of contents lists should be targeted to the node (right) frame. For example:
<A HREF="/HW_modem/modem.remove.html" TARGET="node">Removing a modem</A>
In addition, the name of the HTML file containing the table of contents should be CONTENTS.html; this is the file opened by default by the server when a cross reference points to a directory. However, you can map another filename to CONTENTS.html using the view stanza files.
Next topic: Cross-reference URLs
Previous topic: Man page style guidelines

© 1999 The Santa Cruz Operation, Inc. All rights reserved.
UnixWare 7 Release 7.1.1 - 5 November 1999