====== Utilisation de NsPages ======

L'extension [[doku>>plugin:nspages|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 =====
<code>
<nspages>
</code>

Cette page est dans la catégorie ''wiki:logiciels:dokuwiki''.


<WRAP center round box 90%>
<nspages>

</WRAP>


===== Afficher le titre des pages =====
<code>
<nspages -h1>
</code>

++++ Voir le résultat |
<nspages -h1>
++++

===== Ne pas afficher la page en cours =====
<code>
<nspages -h1 -exclude>
</code>

++++ Voir le résultat |
<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.
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 >
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 >
++++

===== Présentation en liste simple =====
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleList>
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleList>
++++

===== Présentation en liste numéroté =====
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -numberedList>
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -numberedList>
++++

===== Présentation en colonne =====
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLineBreak>
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLineBreak>
++++

===== Présentation en ligne =====
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLine>
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -simpleLine>
++++

===== Présentation sur 4 colonnes =====
<code>
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -nbCol=4>
</code>

++++ Voir le résultat |
<nspages -h1 -exclude -textPages="Pages disponibles pour DokuWiki" -actualTitle=4 -nbCol=4>
++++
<wrap hi>Cette présentation peut être difficile à lire sur un écran de mobile.</wrap>
===== 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>
  
++++ Voir le résultat |  
<nspages -pregPagesOn="/ex/" -h1 -textPages="" -simpleLine -hideNoPages>
++++
  
<wrap hi>Ceci est particulièrement utile si l'on souhaite ne pas afficher un lien si la page est interdite au lecteur via des ACL.</wrap>

===== 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.

<code>
/* Page sommaire */
**<nspages -title -pregPagesOn="/sommaire/" -textPages="" -simpleLineBreak -hideNoPages>**

/* Pages de la racine hors sommaire */
<nspages -title -exclude:[sommaire panneau] -textPages="" -simpleList -hideNoPages>
</code>

++++ Voir le résultat |  
/* 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> 

++++ Voir le résultat |
<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 :
<code txt defaut.txt>
<nspages -h1 -subns -exclude -textPages="Pages disponibles" -hideNoPages -textNS="Catégories disponibles" -hideNoSubns -actualTitle=4 -nbCol=4>
</code>

++++ Voir le résultat |

<nspages -h1 -subns -exclude -textPages="Pages disponibles" -hideNoPages -textNS="Catégories disponibles" -hideNoSubns -actualTitle=4 -nbCol=4>

++++






<WRAP center round box 95%>


++++ Voir la liste des pages de ce dossier |
<nspages -h1  -exclude -textPages="Pages dans ce dossier" -hideNoPages  -hideNoSubns -actualTitle=4 -nbCol=2>
++++

Retour [[.sommaire]]

</WRAP>