3.6.2 Mapped table of contents

A mapped table of contents is a node that contains a table of contents derived from the FrameMaker table of contents; it is a table of contents for the whole web of the FrameMaker document. Each entry in the mapped table of contents exists in the FrameMaker table of contents; the paragraph tags are mapped to TOC-Entry rules.

The contents.wml library file contains TOC-Entry rules that create a mapped table of contents.

To have WebMaker create a mapped table of contents:

• Your FrameMaker document must have a table of contents. When you generate that table of contents in FrameMaker, you must be sure that the Create Hypertext Links box is checked.
• Typically, you want the mapped table of contents to start on a new web page. To make this happen, your FrameMaker document must have a paragraph that acts as the title of the table of contents, in the same flow as the body of the table of contents, and you must map that paragraph tag to a rule that starts a new web page, such as L1H1-NodeTop.
• Include the contents.wml library file in your WML file. (If you use RapidRules on a book file that includes a FrameMaker table of contents, it will include this library file for you.)
• Map the tags from the FrameMaker table of contents to TOC-Entry rules. (If you use RapidRules, it will map these tags appropriately for you.) For example, if your table of contents contains entries for Chapter and 1Heading, the paragraph tags are ChapterTOC and 1HeadingTOC. You could map the ChapterTOC paragraph tag to the TOC-Entry-1 rule and the 1HeadingTOC paragraph rule to the TOC-Entry-2 rule. These TOC-Entry rules vary only in the level of indentation.

Note: the TOC-Entry rules are defined to work for a table of contents of the following format: each entry contains a number (optional), a title, some white space (spaces or tabs), and a page number. The rules strip the page number from the mapped table of contents. If your table of contents has a different format, you may need to define customized versions of the TOC-Entry rules. For general information about editing WML, see Section 10.1, "Creating new WML conversion rules".

Using a similar technique, you can convert similar kinds of lists generated by FrameMaker, such as a list of tables, list of figures, and so on. To do so, you must have generated these lists with the Create Hypertext Links box checked. The contents.wml file contains rules for converting these kinds of lists. For more information, see Section 11.5.1, "Table of contents and related rules", and Section 12.10, "List of figures or tables in WML".