Outils pour utilisateurs

Outils du site


wiki:choix_dokuwiki

Ceci est une ancienne révision du document !


Pourquoi DokuWiki ?

Documentation rédigée par : GADONNAUD Ewen

Formation : BTS SIO 1ère année - Option SISR

Établissement : Lycée Paul-Louis Courier, Tours

Date : Mars 2026

Contexte

Dans le cadre de mon homelab et de ma formation BTS SIO SISR, j'avais besoin d'un outil pour centraliser mes documentations techniques, comptes-rendus de TP et procédures. Plusieurs solutions ont été envisagées avant de retenir DokuWiki.

Solutions envisagées

Solution Type Raison du rejet
Notion SaaS cloud Données hébergées chez un tiers, dépendance à un service externe, contraire à la démarche d'auto-hébergement
Obsidian (seul) Local/fichiers Pas conçu pour être partagé ou consulté depuis un navigateur sans plugin tiers
BookStack Wiki + BDD Nécessite une base de données (MySQL), surcharge pour un usage personnel
MkDocs Générateur statique Adapté à la documentation de projet, mais nécessite un pipeline de build à chaque modification
DokuWiki Wiki auto-hébergé Retenu

Pourquoi DokuWiki

Aucune base de données requise

DokuWiki stocke l'intégralité de son contenu en fichiers plats sur le disque. Dans un contexte homelab où plusieurs services tournent déjà en parallèle, ne pas ajouter un SGBD supplémentaire est un avantage concret en termes de charge et de maintenance.

La sauvegarde se résume à un simple archivage du dossier de données, sans dump SQL ni procédure complexe.

Versioning natif

Chaque modification de page est automatiquement historisée. Il est possible de consulter les différences entre deux révisions et de restaurer une version antérieure à tout moment, directement depuis l'interface web.

Syntaxe cohérente avec mes autres outils

La syntaxe DokuWiki est simple et lisible. Elle s'inscrit dans la continuité des outils déjà utilisés au quotidien (Obsidian, MkDocs), ce qui limite la friction lors de la rédaction.

Export PDF intégré

Chaque page peut être exportée en PDF nativement, sans conversion manuelle. Utile pour produire des livrables dans le cadre de la formation.

Extensibilité via plugins

DokuWiki dispose d'un gestionnaire de plugins intégré. Les extensions s'installent en un clic depuis l'interface d'administration, sans manipulations en ligne de commande.

Ce que DokuWiki n'est pas

DokuWiki n'est pas adapté à tous les usages. Pour de la documentation de projet avec pipeline CI/CD, MkDocs reste plus approprié (c'est d'ailleurs l'outil retenu pour le projet MkDocs “Mille Nuits” en cours de formation). Les deux outils sont donc complémentaires et utilisés en parallèle selon le contexte.

wiki/choix_dokuwiki.1773149523.txt.gz · Dernière modification : de ewen