10 WebMaker Language (WML)

10.8 WML external table of contents

We define an external table of contents as one generated by WebMaker, not FrameMaker.

To trigger an external table of contents, the FrameMaker document must include a single use of a FrameMaker paragraph tag, such as: WWW-TOC. The node type dedicated for this use needs to be specified because:

The function toc(depth, scope) needs to be called with <depth> as maximum and <scope> as global. This is normally not desirable in any other node of the generated web.
This allows for the specification of a FILENAMEKEY for the node of the external TOC, which in turn provides a mechanism to be able to point to this node from anywhere else in the generated web, such as in the navigation panel of other nodes.

For example, suppose we need to create an external full table of contents for a FrameMaker document that has four levels of headings, and we would like to be able to point to it at will. We need:

A paragraph tag, used only once in the FrameMaker document, that is used to trigger the creation of the external TOC.
A FILENAMEKEY for the HTML file of the external TOC.
A node type dedicated for the external TOC.

This is achieved by the following excerpts of WML:

NODE ExternalTOC 
{ 
  TITLE concatenate(maintitle()," - TOC") 
  HEADER { ... } 
  FOOTER { write(*,toc(4,global)) } 
           ...  } 
}

PARAGRAPH "TOCChapter" TYPE Heading 
{  NEWNODE ExternalTOC 
   FILENAMEKEY exttoc 
   LEVEL 1 
   ACTIONS { write(*,heading(1,text())); 
             write(*,hrule());  } 
}

The external table of contents may then be pointed to by the use of the function filename(node) by supplying the specified FILENAMEKEY as parameter, such as:

...
write(*,button("[Contents]",filename(exttoc)));
...

WebMaker User Guide - 27 SEP 1995

Generated with Harlequin WebMaker