DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:toc

Table des matières (TOC)

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.

Astuces

Désactiver la table des matières

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

Ne pas afficher le premier entête dans la table des matières

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.

Configuration

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.

Développement

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

fr/toc.txt · Dernière modification : de 82un0

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki