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

{{ :wiki:logo.png?150 |Logo PLC-SIO}}


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

{{ wiki:dokuwiki-128.png |Logo 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, reste néanmoins un outil pratique pour faire de la documentation on-the-fly |
| 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 "[[https://azuneer.github.io/millenuits-docs/|Mille Nuits]]" en cours de formation). Les deux outils sont donc complémentaires et utilisés en parallèle selon le contexte.