DokuWiki génère automatiquement une table des matière de la page en cours, celle-ci étant généralement placée en haut à droite d'une page. Elle offre un aperçu rapide de la structure du document en listant ses entêtes ou titres (h1, h2, h3 etc.). Chaque élément de la table des matières est un lien permettant de sauter rapidement à la section désirée.

La table des matières s'affiche si un minimum qualifié de titres sont présents sur la page.

La table des matières peut être désactivée sur chaque page en utilisant la macro de contrôle ~~NOTOC~~.

Pour désactiver la table des matières sur l'ensemble du wiki, ajuster le paramètre de configuration maxtoclevel ou tocminheads à 0

On peut empêcher le premier entête en haut de page, souvent le titre de page, d'apparaître dans la TOC en ajustant le paramètre de configuration toptoclevel à 2.

Les paramètres de configuration contrôlent quel niveau de titre doit apparaître dans la table des matières (toptoclevel, maxtoclevel) et combien de titres sont requis pour une table des matières (tocminheads).

• Le paramètre de configuration "toptoclevel" – détermine le niveau d'en-tête maximal à inclure dans la table des matières.
• Le paramètre de configuration "maxtoclevel" – fixe le nombre maximum de niveaux d’en-tête à inclure dans la table des matières.
• Le paramètre de configuration "tocminheads" – fixe le nombre minimum de titres dans la page à partir duquel la table des matières est construite.

Par exemple, dans un wiki avec les paramètres suivants :

• toptoclevel = 2, ie. ===== (dans une page html, correspond à <h2>)
• maxtoclevel = 4, ie. === (dans une page html, correspond à <h4>)
• tocminheads = 3

une page nécessitera d'avoir au moins trois titres d'un niveau de 2-4 pour faire apparaître une table des matières.

• Voir Développement de thèmes DokuWiki

Depuis la version 2008-05-05, la fonction tpl_toc peut être utilisée pour positionner la table des matière n'importe où dans le thème utilisé.

Mise à jour : — Digitalin 2018-01-27 19:59