l_atelier:dokuwiki

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.

Voici les fonctionalisté que j'ai ajouté via l'installation de plugin.

Grace aux plugins oAuth et https://www.dokuwiki.org/plugin:oAuthGeneric, j'ai pu ajouter l'authentification SSO via Authelia + LLDAP

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.

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

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

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

    • claude
      • Reformulation des phrases
      • Correction des fautes d’orthographes
  • l_atelier/dokuwiki.txt
  • Dernière modification : 2025/10/11 19:57
  • de 127.0.0.1