DokuWiki – Utiliser les titres dans la page et la table des matières

Des titres pour structurer les pages

Dans un Wiki, un site web ou tout autre document structuré, les titres permettent de bien organiser les contenus rédactionnels de manière logique. Cette structuration a plusieurs objectifs : permettre de parcourir l’ensemble du document qu’en lisant les titres, de donner envie de lire le contenu de tel ou tel titre… Mais dans les publications web de type Wiki, les titres permettent de créer automatiquement une table des matières (TDM), si vous le désirez. En fonction de l’application que vous utilisez, vous pouvez gérer la création de cette TDM.

L’affichage des titres selon leur niveau d’importance

Dans DokuWiki et les autres systèmes de Wiki, nous pouvons insérer des titres de niveau 1 à 5. Les titres de niveau 1 sont les plus importants et les autres ont une importance décroissante. Ces niveaux d’importance des titres sont parfaitement visibles dans l’affichage des pages. Les titres de niveau 1 sont affichés avec la taille de caractères la plus grande.

De plus dans DokuWiki, les niveaux de titre de 1 à 3 permettent de créer des sections. Chaque section est alors éditable indépendamment des autres sections. Dans cet exemple, seule la section correspondante à un titre de niveau 2 est modifiée.

Paramétrer l’édition des sections

Dans DokuWiki, par défaut seuls les titres de niveau 1 à 3 sont éditables dans la page. Pour modifier ce paramètre, allez dans l’administration, dans les Paramètres de configuration, dans la zone Paramètres d’affichage.

Le paramètre Niveau maximum pour modifier des sections est réglé sur 3. Cela veut donc dire que seuls les niveaux de 1 à 3 permettent aux sections d’être éditables. Si vous indiquez 2, seules les sections de titre de niveau 1 et 2 seront éditables.

Dans cet exemple, la section du titre de niveau 3 n’est éditable que dans la section du titre de niveau 2 :

Gérer l’affichage de la table des matières

Déterminer le nombre minimum de titres pour afficher la table des matières

Dans une page DokuWiki, il ne suffit pas qu’il y ait un titre pour que celui-ci soit affiché dans la TDM. Par défaut, il faut qu’il y ait au minimum trois titres dont le niveau n’importe pas, c’est juste leur nombre qui compte. Pour modifier ce paramètre, dans l’administration des paramètres de configuration, dans la zone Paramètres d’affichage, modifiez la valeur du paramètre Nombre minimum de titres pour qu’une table des matières soit affichée.

Par défaut, il faut qu’il y ait 3 titres au minimum dans la page pour la TDM soit affichée. Vous pouvez bien sûr modifier ce paramètre.

Spécifier les niveaux de titre affichés dans la table des matières

La TDM affiche par défaut les titres de niveau 1 à 3. À nouveau, vous pouvez modifier ces paramètres. Allez dans l’administration des paramètres de configuration, dans la zone Paramètres d’affichage. Pour indiquer le niveau de titre le plus haut à afficher dans la TDM, modifiez la valeur du paramètre Niveau le plus haut à afficher dans la table des matières. Par défaut c’est 1, cela veut dire que les titres de niveau 1 sont affichés dans la TDM.

Si vous indiquez 2,

les titres de niveau 1 ne seront pas affichés dans la TDM :

Dans la TDM, les titres y sont affichés jusqu’au niveau 3. C’est le paramètre Niveau maximum pour figurer dans la table des matières qui le spécifie.

Si vous indiquez 2, les titres de niveau 3 ne seront pas affichés dans la TDM :

Bien utiliser les titres dans l’édition de la page et l’affichage de la table des matières

Nous venons de voir que l’utilisation des titres dans les pages DokuWiki est très importante pour la modification des pages et pour l’affichage de la TDM. Tous ces paramètres sont parfaitement modifiables dans les préférences liées à l’affichage de DokuWiki.