Schémas

Grâce au plugin plugin:diagrams, il est possible de créer des schémas (diagrammes) directement dans le wiki, et de les éditer. Pour ce faire, cliquer sur “Ajouter des images ou d'autres fichiers”, puis “Create a diagram”. Il faut se placer au bon endroit (bonne catégorie) pour que les fichiers soient bien organisés (si je crée un schéma dans une page de la catégorie projets, je dois voir “Create a diagram in current namespace :realisations:projets”). J'entre le nom de mon schéma (le plus clair possible, sans espaces et accents).

Un fichier SVG est créé (format vectoriel, le même qu'utilise Inkscape par exemple), et l'éditeur de diagrammes s'ouvre. On peut ajouter des formes, des flèches, du texte, des couleurs, c'est assez simple à comprendre.

Quand j'ai fini, je clique sur Save pour enregistrer mon fichier. Je peux le rééditer à tout moment grâce au bouton “Edit diagram”.

Exemple de diagramme :

Pour quoi faire ? → boutons qui envoient sur d'autres pages, table des matières…

Comment ? On peut ajouter des liens aux objets du diagramme : il faut faire un clic droit sur l'objet (rond…) quand on édite le diagramme, et aller dans “Edit Link…”. On peut alors entrer le lien qu'on souhaite. Si on veut qu'il s'ouvre dans un nouvel onglet, on coche la case “Open in a new window”.
Attention, il faut entrer un lien absolu, ça ne marche pas avec un lien relatif interne au wiki, qui serait alors ajouté au lien du fichier SVG. Si on déplace des pages il faut donc vérifier les liens à la main (le plugin move n'éditera pas les liens dans les fichiers SVG).
On peut utiliser des liens qui renvoient à des sections d'une page du wiki en ajoutant “#nom_de_la_section” à la fin de l'adresse. Si on a un doute sur la syntaxe, on peut faire un clic droit sur la section dans la table des matières de la page en question, et copier le lien.

Exemple → cliquer sur le soleil du diagramme, qui nous amène à la section Installation en bas de la page.

Pour quoi faire ? → annoter une image (encercler et flécher des éléments qu'on veut mettre en avant), utiliser des icônes dans notre diagramme…

Comment ? → copier le lien de son image (par exemple depuis le gestionnaire multimédia). Editer le diagramme et aller dans Arrange/Insert/Image et coller le lien.

Exemple → dans le diagramme exemple de cette page, ou dans cet exemple de capture d'écran annotée :

Si vous installez ce plugin sur votre dokuwiki, il faut ajouter un fichier mime.local.conf dans /var/www/dokuwiki/conf. Ce fichier texte (on peut le créer avec l'appli Notepad), doit contenir svg image/svg+xml. Ce fichier permet la création et l'édition de fichiers SVG dans le gestionnaire multimedia (voir mime).