Home » Download » Modules

Table of Contents

· ·
deviantintegral - December 4, 2006 - 22:24

This module generates a table of contents and corresponding links to headings within a document. All of the work is done through the input filter system.

— I'm looking for a co-maintainer for this module. If you're interested, please file an issue in the issue queue.

Hi guys! I'm Alexis and I was given permissions to work on the Table of Content module. I have been looking at a few issues and I'm thinking of making changes to the module more or less as follow. Please, if you have comments and/or other ideas, feel free to post them as an issue. Patches welcome, although there will be quite many changes to the code...

  • Remove the Anchor filter and integrate it in the core filter. This will enable the TOC filter to do several things that would otherwise be harder to do: (1) auto-generate a TOC based of parameters such as how many paragraphs, chapters you have in your node; (2) avoid problems with min/max levels (see notes below);
  • Change the filter code itself so it can be reused in different situation, most specifically, to be able to put the TOC in a block. We also want to be able to generate a toc for another node, or even a set of nodes (a summary as in a book, but based on pages & anchors instead of just anchors in one page.) With caching that should give us something quite good.
  • Make the use of [toc ...] official; although I'd like to fade out the use of the comment, I guess a lot of people like it. But I think it should not be the official use of the filter since it makes it a lot more complicated to enter a TOC in a node using a WYSIWYG editor.
  • Better/stronger handling of the theming capabilities so the result is more up to snuff in regard to being compliant, etc. This may already be pretty good though.

Note about heading levels

This module supports choosing the minimum and maximum heading levels for a table of contents. This can cause unexpected output in your page if, for example, the minimum level is set to "h2" and your headings start at "h3". Please see the README documentation for more details.

Releases

Official releasesDateSizeLinksStatus
6.x-3.02009-Jun-3017.65 KBDownload · Release notesSupported for 6.xThis release is supported but is not currently the recommended release for 6.x.
6.x-2.32009-Jun-3017.65 KBDownload · Release notesRecommended for 6.xThis is currently the recommended release for 6.x.
5.x-2.22008-Aug-1812.49 KBDownload · Release notesRecommended for 5.xThis is currently the recommended release for 5.x.
Development snapshotsDateSizeLinksStatus
6.x-3.x-dev2009-Jul-0117.66 KBDownload · Release notesDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.
6.x-2.x-dev2009-Jun-3017.65 KBDownload · Release notesDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.
5.x-2.x-dev2009-Mar-1917.34 KBDownload · Release notesDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.


 
 

Drupal is a registered trademark of Dries Buytaert.