wml::std::toc(3)

wml::std::toc3

Table of contents generation

Usage

 #use wml::std::toc [style={pre,nbsp,hspace,ul,ol} [type=...]]
 <toc>
 <hN>...</hN>
 <toc_hN ...>...</toc_hN>

Overview

This creates a table of contents which can be inserted at any point (even more than once) by the "<toc>" tag. The contents gets created out of all header tags ``"<hN>"'' where ``N'' also controls the indention in the table of contents.

Alternatively you can use the "<toc_hN>" tags to insert its body (can be empty!) at the current location and into the Table Of Contents. If specified, the "alt" attribute is included into the ToC instead of the body.

Styles

You may specify any of the five styles "pre", "nbsp", "hspace", "ul" and "ol". The last two accept special options to render HTML lists. With "style=ol", you may choose types 1, "A", "a", "i" and "I" whereas "style=ul" provides "d", "c" and "s" for respectively discs, circles and squares.

Examples

Below is an example to render the Table of Contents with HTML "<pre>" tag.

 #use wml::std::toc style=pre
 #use wml::std::page
 <page>
 <h1>Chapter 1</h1>
 <h2>Section 1</h2>
 <h2>Section 2</h2>
 <h1>Chapter 2</h1>
 <h2>Section 1</h2>
 <h2>Section 2</h2>
 <toc>

Play and choose your favorite!

 #use wml::std::toc style=ol type=A1ai

or

 #use wml::std::toc style=ul type=dssccc

Requires

 Internal: P1, P2, P5, P6

Releases

15 releases since Debian 2.0 (Hamm); the text changed 12 times.

  1. 2.0
  2. 2.1
  3. 2.2
  4. 3.0
  5. 3.1
  6. 4.0
  7. 5.0
  8. 6.0
  9. 7
  10. 8
  11. 9
  12. 10
  13. 11–13

Authors

 Ralf S. Engelschall
 [email protected]
 www.engelschall.com
 Denis Barbier
 [email protected]

From wml 2.32.0~ds1-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.