The TOC file format
Table of Contents
Each book contains a file named help_toc.xml. This file populates the Table of Contents pane, and determines the order and structure of the book.
This section describes the format and tags of the help_toc.xml file.
The help_toc.xml file must meet standard XML requirements, and must contain the following document prolog:
<?xml version="1.0" encoding="UTF-8"?>
Download a sample help_toc.xml file
book
Description
The root element of the help_toc.xml file.
Attributes
title
, directory
, language
, version
, sort
title
The title of the book as it should appear in the Help panel TOC.
directory
The directory of the book
language
The local language code.
version
The current version of the book, for tracking purposes. This is an optional attribute.
sort
Determines the order of the book in the TOC. The format recommended format is a unique prefix followed by an underscore and a number (for example, myBooks_1
). The prefix mm
is reserved for Macromedia documents.
Contents
This tag must contain one or more level
tags.
Container
None.
Example
<book title="Getting Started with Flash" directory="GettingStarted" language="en" version="1.0" sort="mm_1"> ... </book>
level1, level2, level3
Description
Tags that list the topics in a book and determines the level of the topic in the TOC.
Attributes
href
, name
href
The relative URL of the topic's associated HTML page. This attribute is not required for level tags followed by subordinate level tags.
name
The name of the topic as it should appear in the TOC.
Contents
None.
Container
These tags must be contained by a book tag.
Example
<level1 name="Getting to Know the Workspace" /> <level2 href="03_Working.html" name="Overview" /> <level2 name="Using the Stage" /> <level3 href="03_Working2.html" name="Working with the stage" />