dokuwiki permet d'écrire facilement de la documentation avec une syntaxe wiki sensiblement identique à Wikipedia
Pourquoi dokuwiki
Dans un premier temps, je voulais chercher une version plus moderne à dokuwiki, car il faut avouer, qu'au premier abord, l'on sent bien que dokuwiki date un peu, la premiere version est sortie en 2004
J'ai donc cherché d'autres wiki avec les critères suivants :
- En priorité la gestion par fichier
- Support du SSO
- Possibilité d'avoir des namespaces
- Customisable via des plugins intéréssant
- Simple à utiliser
J'ai donc testé WikiJS, il est clair que niveau ergonomie, il est plus en adequation avec ce qu'il se fait aujourd'hui (il est dévéloppé en TypeScript) contrairement à DokuWiki qui est developpé en PHP. Bien qu'intéréssant, je n'étais pas sastifait de WikiJS, je me suis égallement documenté sur BookStack, il ne m'a pas convaincu sur le papier.
Je me suis donc rabatu sur DokuWiki et j'avoue qu'avec quelques plugins, il répond parfaitement à mes besoins et j'en suis vraiment sastifait.
Configuration
Voici les fonctionalisté que j'ai ajouté via l'installation de plugin.
🪪 Support de l'authentification via SSO
Grace aux plugins oAuth et https://www.dokuwiki.org/plugin:oAuthGeneric, j'ai pu ajouter l'authentification SSO via Authelia + LLDAP
💾 Coloration syntaxique
Par defaut DokuWiki utilise la coloration syntatique fournit pas l'outil GeSHi (Generic Syntax Highlighter). De nombreux language ne sont pas supporté, comme par exemple Nix, j'ai donc opté pour le plugin codeprism qui supporte de nombreux language supplémentaires.
ℹ️ Notes informatives
Contrairement à la syntaxe markdown qui support les notes informations (Note, Warning, Critical), DokuWiki n'a pas de notes informatives, pour corriger cela, j'ai utilisé le plugin Note Plugin
💬 Traduction multi-lingue
Depuis presque 30 ans, je profite de l'experiance d'autres passioné qui partage leurs savoirs faire, je vais parti égallement de ces personnes qui en quelques sorte en retour partage mon savoir faire, je le partage en francais, mais m'allimentant beaucoup avec des ressources anglais, je trouve normal de le partager égallement en anglais, pour cela, j'utilise le plugin DeepL Autotranslate Plugin. Ce plugin permet de traduire automatiquement une page vers une autre langue
🎨 Style
Afin d'améliorer le style de DokuWiki, j'ai égallement ajouté le theme Bootstrap3 Template ainsi que le plugin Wrap Plugin qui permet d'ajouter le support des block HTML div et span
Sources
-
- claude
- Reformulation des phrases
- Correction des fautes d’orthographes