🛠️ 🌐 📋 DokuWiki

🌟 Magie

Grâce à DOKUWIKI on peut très facilement publier proprement des pages de notes avec des images, des tableaux, du code… et on peut décider des droits ouverts aux autres personnes : accès à la lecture, à l'inscription et à la co-édition.

🌠 la Table des Matières : générée automatiquement à partir des titres dans chaque page. Cela permet de naviguer dans une page dense, mais aussi d'éditer les contenus morceaux par morceaux.

🌠 les Notes de Bas de Pages faciles : il suffit d'inscrire du texte entre 2 parenthèses pour qu'il devienne une info complémentaire ²⁾

🌠 des thèmes et des extensions existent pour affiner les options et construire le site que l'on souhaite. 📖 voir dans la doc

On peut modifier une page entière ou juste une section de la page, et on crée une nouvelle page en créant le lien qui pointe vers elle = au moment où on en a besoin

🌠 La collaboration ou édition à plusieurs: c'est l'objectif principal de ce type d'outil mais comme toujours l'installation ne suffit pas à garantir le résultat…

le Wiki vous contraindra d’abord à vous concentrer sur le fond puisque vous ne pourrez pas élaborer une mise en forme avancée. ³⁾

Créer une page

Pour cela on crée d'abord un lien qui pointe vers elle, avec la syntaxe des liens internes :

[[Nouvelle Page]] 

qui va afficher Nouvelle Page. Le lien mène alors vers une page “à créer”, il suffit d'y ajouter du contenu pour la faire exister.

On peut évidemment choisir d'écrire un texte différent du nom de la page pour libeller son lien :

[[playground:syntaxedoku0|Prise en main, - bac à sable syntaxe dokuwiki ]]& structure d'une page "brute"

permet de créer la page syntaxedoku0 dans la partie playground du site.
Cela affiche : Prise en main, - bac à sable syntaxe dokuwiki & structure d'une page “brute”.

Créer un lien

L'éditeur transforme automatiquement les URL complètes en liens cliquables, ex : https://www.jecherchedesproblemes.com/
Si on veut personnaliser le texte du lien la syntaxe est assez simple :

 [[https://www.jecherchedesproblemes.com/|le site portfolio d'un designer talentueux]]

donnera : le site portfolio d'un designer talentueux

Afficher des images

{{wiki:dokuwiki-128.png?50| description}} 

donnera :

📁 Dossiers: catégories ou espaces de noms

Pour créer une arborescence on distingue
- les liens internes voisins, pour faire une page sœur de celle où nous sommes créés avec le raccourci [[nouvelle page]]
- des liens internes enfants qui s'écrivent avec un tilde : [[~:nouvelle page]].

Ce qui donnerait : nouvelle page (au même niveau que la page actuelle) et nouvelle page (enfant de la page actuelle).

Pour taper un tilde au clavier c'est AltGr+2
et si on veut créer une page “à la racine” du wiki depuis n'importe quelle autre page on ajoute : [[:nouvelle page racine]]
qui donne nouvelle page racine

📃 Pages

Le centre du wiki: des documents plus ou moins longs, plus ou moins structurés… Chacun possède une URL.

📃 mini-pages spéciales

Pour gérer un menu, la sidebar…etc il suffit de créer la page correspondante qui devrait s'afficher automatiquement “à sa place”. sidebar footer

Il y a plusieurs pages concernées par ces "Hooks" détaillés ici. Si ça ne fait pas comme on veut: vérifier la configuration

Vu la liberté de création de pages “partout” et selon les utilisateurs visés il vaut mieux définir ensemble les quelques espaces de noms “principaux” situés en racine du site qui permettront de “ranger” tous les contenus envisagés.

Ici j'ai tenté un truc “simple” :

• 📁 notes
  • 📁 notes de cours
  • 📁 notes de lectures
  • 📁 perso
• 📁 outils
  • 📁 du web
  • 📁 pour imprimer en 3D
  • 📁 pour découper - graver
• 📁 web
• 📁 projets
  • 📁 asso
  • 📁 secret

Mais bon c'est un espace perso donc ça n'a pas beaucoup d'importance…

Modèles de pages

On a vu que dans chaque 📁 catégorie on peut “invoquer” une sidebar, un footer…etc. Plus fort: on peut créer un gabarit de page pré-structurée pour tout le site ou pour chaque dossier, simplement en créant le fichier _template.txt à la racine de l'espace de nom (par FTP). voir la doc

Créer des menus