Generate table of contents
This plugin analyzes the HTML header statements (h1, h2, h3 ...) and generates a table of contents based on this information.
ConfigurationÂ
toc_min_linesÂ
A page needs with less lines than specified won't get a table-of-contents.
You can use this if you paste the table-of-contents to some screen corner, and don't want the clutter the display if the HTML page is very short anyway.
If not specified, this defaults to 30.
Internal representationÂ
Given this HTML ...
Calling macros
Example
Defining macros
... the plugin populates the variable "_toc" like this:
_toc = [
(2, "Calling macros", "calling_macros"),
(3, "Example", "example"),
(2, "Defining macros", "defining_macros"),
]
... where the first item is the level (h1, h2, etc). The second item is the headline and the last element is a so-called slug, used for local anchors.
Generation of a table-of-contentsÂ
This again is done via a suitable Mako templates. The template uses
the function "get_toc()" and returns (level, headline, slug) tuples.
- "
level" is the indentation level, starting with 0. You can use this for CSS "id=" or "class" attributes - "
headline" is the headline (the text inside.. ) - "
slug" is the slug that can be used for link creation
Example templateÂ
Here's a sample Mako template excerpt that converts this into a HTML:
% for level, headline, link in toc:
- ${headline | entity}
% endfor
Example CSSÂ
Finally, you use some CSS to format the table-of-contents to your liking, e.g. with this:
#toc, #toc ul {
list-style-type: none;
overflow: hidden;
padding: 0;
margin: 0;
}
#toc {
font-size: 90%;
}
#toc li {
width: 100%;
text-align: right;
}
.toc1 { padding-left: 1em; }
.toc2 { padding-left: 2em; }
Â
