---

[ Main Table Of Contents | Table Of Contents | Keyword Index | Categories | Modules | Applications ]

---

NAME

doctools::toc::export::html - HTML export plugin

Table Of Contents

• Table Of Contents

• Synopsis

• Description

• API

• Configuration

• ToC serialization format

• Bugs, Ideas, Feedback

• Keywords

• Category

• Copyright

SYNOPSIS

package require Tcl 8.4
package require doctools::toc::export::html ?0.1?
package require doctools::text
package require doctools::html
package require doctools::html::cssdefaults

export serial configuration

DESCRIPTION

This package implements the doctools table of contents export plugin for the generation of HTML markup.

This is an internal package of doctools, for use by the higher level management packages handling tables of contents, especially doctools::toc::export, the export manager.

Using it from a regular interpreter is possible, however only with contortions, and is not recommended. The proper way to use this functionality is through the package doctools::toc::export and the export manager objects it provides.

API

The API provided by this package satisfies the specification of the doctoc export plugin API version 2.

• export serial configuration

  This command takes the canonical serialization of a table of contents, as specified in section ToC serialization format, and contained in serial, the configuration, a dictionary, and generates HTML markup encoding the table. The created string is then returned as the result of the command.

Configuration

The html export plugin recognizes the following configuration variables and changes its behaviour as they specify.

• string user

  This standard configuration variable contains the name of the user running the process which invoked the export plugin. The plugin puts this information into the provenance comment at the beginning of the generated document.

• string file

  This standard configuration variable contains the name of the file the table of contents came from. This variable may not be set or contain the empty string. The plugin puts this information, if defined, i.e. set and not the empty string, into the provenance comment at the beginning of the generated document.

• dictionary map

  This standard configuration variable contains a dictionary mapping from the (symbolic) document ids in reference entries to the actual filenames and/or urls to be used in the output.

  Document ids without a mapping are used unchanged.

• boolean newlines

  If this flag is set the plugin will break the generated html code across lines, with each markup command on a separate line.

  If this flag is not set (the default), the whole document will be written on a single line, with minimum spacing between all elements.

• boolean indented

  If this flag is set the plugin will indent the markup commands according to the structure of indices. To make this work this also implies that newlines is set.

  If this flag is not set (the default), the output is formatted as per the value of newlines, and no indenting is done.

• string meta

  This variable is meant to hold a fragment of HTML (default: empty). The fragment it contains will be inserted into the generated output in the section of the document, just after the