Table des matières
Utilisation de NsPages
L'extension nspages permet de générer automatiquement la table des matières d'une catégorie et éventuellement de ses sous-catégories.
Syntaxe de base
<nspages>
Cette page est dans la catégorie wiki:logiciels:dokuwiki.
Pages dans la catégorie :
Afficher le titre des pages
<nspages -h1>
Ne pas afficher la page en cours
<nspages -h1 -exclude>
Modifier le titre de la table des pages
Il est possible de remplacer le texte par défaut pour la table des pages et d'utiliser un titre standard, ici de niveau 4.
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 >
Présentation en liste simple
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleList>
Présentation en liste numéroté
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -numberedList>
Présentation en colonne
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLineBreak>
Présentation en ligne
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLine>
Présentation sur 4 colonnes
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -nbCol=4>
Cette présentation peut être difficile à lire sur un écran de mobile.
Trier les pages
Il est toujours possible de trier la liste des pages quelle que soit la présentation.
Afficher des pages particulières
Il est possible de sélectionner une ou des pages particulières.
<nspages -pregPagesOn="/ex/" -h1 -textPages="" -simpleLine -hideNoPages>
Ceci est particulièrement utile si l'on souhaite ne pas afficher un lien si la page est interdite au lecteur via des ACL.
Afficher les pages de la catégorie en cours avec le sommaire en tête
Ceci est particulièrement utile dans un panneau latéral.
/* Page sommaire */ **<nspages -title -pregPagesOn="/sommaire/" -textPages="" -simpleLineBreak -hideNoPages>** /* Pages de la racine hors sommaire */ <nspages -title -exclude:[sommaire panneau] -textPages="" -simpleList -hideNoPages>
Afficher les catégories
On peut afficher uniquement les sous-catégories -subns -nopages d'une catégorie donnée, ici wiki:experience.
D'autre part le tri est réalisé sur l'identifiant de la catégorie -sortId pour éviter un problème avec le É.
<nspages wiki:experience -h1 -subns -nopages -textNS="Mes expériences non professionnelles" -actualTitle=5 -simpleLine -sortId>
Code par défaut
Dans les paramètres de configuration il est possible de spécifier un code par défaut qui est inséré lors de l'utilisation du bouton de l'éditeur de page. Voici un exemple :
- defaut.txt
<nspages -h1 -subns -exclude -textPages="Pages disponibles" -hideNoPages -textNS="Catégories disponibles" -hideNoSubns -actualTitle=4 -nbCol=4>