**[[https://www.dokuwiki.org/dokuwiki|dokuwiki]]** permet d'écrire facilement de la documentation avec une syntaxe wiki sensiblement identique à [[https://wikipedia.org|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 [[https://www.dokuwiki.org/plugin:oauth|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 [[https://github.com/GeSHi/geshi-1.0|GeSHi (Generic Syntax Highlighter)]]. De nombreux language ne sont pas supporté, comme par exemple [[NixOs|Nix]], j'ai donc opté pour le plugin [[https://www.dokuwiki.org/plugin:codeprism|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 [[https://www.dokuwiki.org/plugin:note|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 [[https://www.dokuwiki.org/plugin:deeplautotranslate|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 [[https://www.dokuwiki.org/template:bootstrap3|Bootstrap3 Template]] ainsi que le plugin [[https://www.dokuwiki.org/plugin:wrap|Wrap Plugin]] qui permet d'ajouter le support des block HTML ''div'' et ''span'' * ===== Sources ===== * [[:CharteIA]] * claude * Reformulation des phrases * Correction des fautes d’orthographes