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

Ce service est la documentation technique du projet.
Basé sur [[https://dokuwiki.org/|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]] :
<code bash>
apt install dokuwiki
</code>

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''.

==== Greffons ====

Ajout manuel des greffons (déplacement depuis l'ancienne instance DokuWiki) :

  * ''usermanager'' ;
  * ''note'' ;
  * ''wrap''
  * ''gallery'' ;
  * ''removeold''.

Après installation il a fallut purger les fichiers 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 dépôt Git ====

Un script est installé dans ''/var/lib/git/commit_auto_doku/'' pour synchroniser les données avec un dépôt Git, permettant aux admins d'avoir accès à une documentation hors ligne en cas de gros pépin.

===== Personnalisation =====

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

Voir le [[https://agir.april.org/issues/5016|ticket n°5016]].

L'explication :
<code bash>
cd /var/www/dokuwiki/conf/
head -5 mime.conf
</code>
<code>
# 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 bash>
cd /var/www/dokuwiki/conf/
cat mime.local.conf
</code>
<code>
svg      image/svg+xml
</code>