12.9.2 Mapped table of contents

For basic information about a mapped table of contents, see Section 3.6.2, "Mapped table of contents". We define a mapped table of contents as one that was created in FrameMaker, and whose entries are mapped to WML rules.

The best way to understand how a mapped table of contents works in WML is to look at the rules in the library files that support them:

• The library file contents.wml contains paragraph rules that are intended to be used for the paragraph tags that appear in the FrameMaker table of contents. Notice, in particular, that each of these rules specifies TOC as the FILENAMEKEY.
• The library files nodesTI.wml and nodesBTI.wml define nodes that have a Contents button, which links to the table of contents. The definition of the Contents button uses the filename function with the argument TOC.

It is important to understand how WebMaker determines which HTML file is the distinguished table of contents, that is, the one that is the target of the Contents button. First, if any paragraph in the document has a tag that is mapped to the rule ExtTOCHeading-TocNode, then the HTML file containing that paragraph is the distinguished table of contents. Otherwise, if any paragraphs in the document have tags that are mapped to any of the TOC-Entry rules, then the first HTML file containing a paragraph whose tag was mapped to a TOC-Entry rule is the distinguished table of contents.

Note that the expectation of the library rules is that users will choose either a generated table of contents or a mapped table of contents, but not both.