<WRAP info>**[[https://www.dokuwiki.org/dokuwiki|dokuwiki]]** makes it easy to write documentation with a wiki syntax that is virtually identical to [[https://wikipedia.org|Wikipedia]]</WRAP>

====== Why dokuwiki ======

Initially, I wanted to look for a more modern version of dokuwiki, because I have to admit that, at first glance, dokuwiki looks a bit dated, the first version was released in **2004**

So I looked for other wikis with the following criteria:

  * File management as a priority
  * SSO support 
  * Ability to have namespaces
  * Customisable via interesting plugins
  * Simple to use

So I tested WikiJS, and it's clear that in terms of usability, it's more in line with what's being done today (it's developed in TypeScript) unlike DokuWiki which is developed in [[l_atelier:php]] . Although interesting, I wasn't satisfied with WikiJS, I also read up on BookStack, which didn't convince me on paper.

So I fell back on DokuWiki and I have to admit that with a few plugins, it meets my needs perfectly and I'm really happy with it.

===== Configuration =====

Here are the features I added via plugin installation.

==== 🪪 Support for SSO authentication ====

Thanks to the plugins [[https://www.dokuwiki.org/plugin:oauth|oAuth]] and [[https://www.dokuwiki.org/plugin:oAuthGeneric]], I've been able to add SSO authentication via [[l_atelier:authelia]] + [[l_atelier:lldap]]

==== 💾 Syntax highlighting ====

By default DokuWiki uses the syntax highlighting provided by the tool [[https://github.com/GeSHi/geshi-1.0|GeSHi (Generic Syntax Highlighter)]]. Many languages are not supported, for example [[l_atelier:nixos|Nix]], so I opted for the plugin [[https://www.dokuwiki.org/plugin:codeprism|codeprism]] which supports many additional languages.

==== ℹ️ Notes ====

Unlike markdown syntax, which supports informative notes (Note, Warning, Critical), DokuWiki does not have informative notes. To correct this, I used the plugin [[https://www.dokuwiki.org/plugin:note|Note Plugin]]

==== 💬 Multi-lingual translation ====

For almost 30 years, I've been benefiting from the expertise of other enthusiasts who share their know-how, and I'm also benefiting from these people who, in return, share my know-how. I share it in French, but as I use English resources a lot, I find it normal to share it in English as well. [[https://www.dokuwiki.org/plugin:deeplautotranslate|DeepL Autotranslate Plugin]]. This plugin automatically translates a page into another language.

==== 🎨 Style ====

To improve the style of DokuWiki, I've also added the theme [[https://www.dokuwiki.org/template:bootstrap3|Bootstrap3 Template]] and the plugin [[https://www.dokuwiki.org/plugin:wrap|Wrap plugin]], which adds support for HTML blocks ''div'' and ''span''
  * 


===== Sources =====

  * [[en:charteia]]
    * claude
      * Reformulation of sentences
      * Correction of spelling mistakes