Différences

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

--- asso:tuto:wiki [2020/10/27 14:53] – qduchemi
+++ asso:tuto:wiki [2021/09/01 14:44] (Version actuelle) – qduchemi
@@ Ligne 1: / Ligne 1: @@
-# Utilisation et contribuer au Wiki
+# Utilisation et contribution au Wiki
 ## Organisation
@@ Ligne 27: / Ligne 27: @@
 <bootnote>Le plugin [bootnote](https://www.dokuwiki.org/plugin:bootnote) permet de créer des cadres attirant l'attention sur une information.</bootnote>
+Lors de l'édition d'une page, un bouton permet de facilement créer des cadres : ![](https://wiki.picasoft.net/lib/plugins/bootnote/images/note.png)
 ### Gestion des liens
@@ Ligne 50: / Ligne 52: @@
 ### Création d'une page
-Dans la barre de menu, en haut, l'icône en forme de document vide (![](https://wiki.picasoft.net/lib/exe/fetch.php?media=asso:tuto:new_page.png)) vous permettra de créer une nouvelle page. Il vous faudra choisir la catégorie appropriée. Les catégories existantes à ce jour devraient suffire pour la plupart des cas.
+Dans la barre de menu, en haut, l'icône en forme de document vide vous permettra de créer une nouvelle page. Il vous faudra choisir la catégorie appropriée. Les catégories existantes à ce jour devraient suffire pour la plupart des cas.
 Il est possible de créer une page directement en modifiant l'URL d'une page existante. Par exemple, pour créer cette page, je me suis simplement rendu sur l'URL `https://wiki.picasoft.net/doku.php?id=asso:tuto:wiki` et j'ai cliqué sur le bouton de modification de la page.
@@ Ligne 62: / Ligne 64: @@
 Vous remarquerez que par défaut, les catégories n'ont pas de nom "lisible par l'homme", mais que leur identifiant s'affiche. Pour des raisons de lisibilité, si on veut y attribuer un nom arbitraire, il faudra créer une page `start` dans la catégorie nouvellement créée, et lui assigner un titre (avec `#` en Markdown).
-La catégorie deviendra alors cliquable dans l'arborescence et amènera sur la page `start`, qui ne contient que le titre. Il est alors de bon ton d'y ajouter un index auto-généré, ce qui peut être fait avec cette syntaxe (remplacez `categorie` et `sous-categorie` par les bons noms) :
+La catégorie deviendra alors cliquable dans l'arborescence et amènera sur la page `start`, qui ne contient que le titre. Il est alors de bon ton d'y ajouter un index auto-généré, ce qui peut être fait avec cette syntaxe :
 ```
-{{indexmenu>:categorie:sous-categorie:...|js#bitrix msort tsort msort nsort notoc nomenu nocookie navbar}}
+{{.|js#bitrix msort tsort msort nsort notoc nomenu nocookie navbar}}
 ```
+<bootnote learn>Le `.` indique de commencer l'arborescence à partir du niveau courant, celui de la page `start`. Le reste permet d'indiquer les critères utilisés pour l'ordonnancement, le thème... Le bouton d'aide d'Indexmenu, lors de l'édition d'une page, permet d'aider à la génération d'un index : ![](https://wiki.picasoft.net/lib/plugins/indexmenu/images/indexmenu_toolbar.png)</bootnote>
+<bootnote>Il est possible d'utiliser une catégorie "en dur" à la place du `.`, comme `:txs:secu:p20`, mais en cas de déplacement de la catégorie, l'arborescence ne suivra pas. Il est donc préférable d'utiliser des chemins relatifs.</bootnote>
 ### Exemple concret
@@ Ligne 77: / Ligne 83: @@
 # Audit de sécurité de l'infrastructure de Picasoft
-{{indexmenu>:txs:secu:p20|js#bitrix msort tsort msort nsort notoc nomenu nocookie navbar}}
+{{indexmenu>.|js#bitrix msort tsort msort nsort notoc nomenu nocookie navbar}}
 ```
@@ Ligne 122: / Ligne 128: @@
 Cette solution est préférée car automatique et sans besoin d'intervention manuelle quand une nouvelle page est intercalée.
+<bootnote>
+Le bouton d'indexmenu accessible lors de l'édition permet de facilement générer la balise en rentrant le numéro de tri : ![](https://wiki.picasoft.net/lib/plugins/indexmenu/images/indexmenu_toolbar.png)
+</bootnote>