======= Service admin.chapril.org =======

Ce service est la documentation technique du projet. Basé sur Dokuwiki.

<note tip>
La doc upstream est ici :
  * https://www.dokuwiki.org/fr:install:debian
  * https://wiki.debian.org/fr/DokuWiki
</note>

===== Installation =====

Sur la [[admin:machines_virtuelles:admin|VM admin]]:
  apt install dokuwiki

Avec Bookworm, des patchs sont [[https://agir.april.org/issues/6345|requis]].
==== Configuration ====

Les comptes et les ACL sont créés dans ''/etc''. Cf ''etckeeper'', notamment le commit ''4e1636b''.

==== Plugins ====

Ajout manuel des plugins (déplacement depuis l'ancien dokuwiki) :

  * usermanager
  * note
  * wrap
  * gallery
  * removeold

Après installation il a fallut purger les css et js avec
  * https://admin.chapril.org/lib/exe/css.php?purge=true
  * https://admin.chapril.org/lib/exe/js.php?purge=true
==== Synchronisation avec un repos Git ====

Un script est installé dans ''/var/lib/git/commit_auto_doku'' pour synchroniser les données avec un repos Git, permettant aux admins d'avoir accès à une doc offline en cas de gros pépin.
===== Personnalisation =====

==== Autoriser le téléversement de fichiers svg ====

Voir ticket https://agir.april.org/issues/5016.

L'explication :
<code>
=(^-^)=root@admin:/var/www/dokuwiki/conf# head -5 mime.conf 
# Allowed uploadable file extensions and mimetypes are defined here.
# To extend this file it is recommended to create a mime.local.conf
# file. Mimetypes that should be downloadable and not be opened in the
# should be prefixed with a !
</code>

Du coup, création :
<code>
=(^-^)=root@admin:/var/www/dokuwiki/conf# cat mime.local.conf
svg      image/svg+xml
</code>