DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:toc

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
fr:toc [2015-05-04 22:03] 2a01:e35:8a3f:b080:c473:af2:2de8:2ef1fr:toc [2023-12-26 10:49] (Version actuelle) 82un0
Ligne 1: Ligne 1:
 ====== Table des matières (TOC) ====== ====== Table des matières (TOC) ======
  
-[[fr:DokuWiki]] est capable de générer automatiquement une table des matière de la page en cours. Elle offre un aperçu rapide de la structure du document en listant ses entêtes (H1H2H3 etc.). Chaque élément de la table des matières est un lien permettant de sauter rapidement à la section désirée. Elle est généralement ====== placée ====== +[[fr: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 
- en haut à droite d'une page+Elle offre un aperçu rapide de la structure du document en listant ses entêtes ou titres (h1h2h3 etc.).  
 +Chaque élément de la table des matières est un lien permettant de sauter rapidement à la section désirée. 
  
-Depuis la version ''2008-05-05'' de DokuWiki, la fonction [[fr:devel:templates#tpl_toc]] peut être utilisée pour positionner la table des matière n'importe où dans le template utilisé.+La table des matières s'affiche si un [[#configuration|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 [[fr:wiki:syntax#macros|macro de contrôle]] **''%%~~NOTOC~~%%''**. 
 +
 +Pour désactiver la table des matières sur l'ensemble du wiki,  ajuster le paramètre de configuration  [[fr:config:maxtoclevel]] ou [[fr:config: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 [[fr:config:toptoclevel]] à ''2''.
  
 ===== Configuration ===== ===== Configuration =====
  
-  * [[fr:config:toptoclevel|Paramètre de configuration "toptoclevel"]] +Les paramètres de configuration contrôlent quel niveau de titre doit apparaître dans la table des matières ([[fr:config:toptoclevel]], [[fr:config:maxtoclevel]]) 
-  * [[fr:config:maxtoclevel|Paramètre de configuration "maxtoclevel"]]+et combien de titres sont requis pour une table des matières ([[fr:config:tocminheads]]). 
 + 
 +  * Le paramètre de configuration [[fr:config:toptoclevel| "toptoclevel"]] -- détermine le niveau d'en-tête maximal à inclure dans la table des matières. 
 +  * Le paramètre de configuration [[fr:config:maxtoclevel|"maxtoclevel"]] -- fixe le nombre maximum de niveaux d’en-tête à inclure dans la table des matières. 
 +  * Le paramètre de configuration [[fr:config:tocminheads|"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 ===== ===== Développement =====
  
-  * [[fr:devel:templates|Développement de templates DokuWiki]]+  * Voir [[fr:devel:templates|Développement de thèmes DokuWiki]] 
 + 
 +Depuis la version **''2008-05-05''**,  la [[fr:devel:templates#fonctions| fonction tpl_toc]] peut être utilisée pour positionner la table des matières n'importe où dans le thème utilisé. 
fr/toc.1430769805.txt.gz · Dernière modification : 2015-05-04 22:03 de 2a01:e35:8a3f:b080:c473:af2:2de8:2ef1

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