Outils pour utilisateurs

Outils du site


services:admin.chapril.org

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
services:admin.chapril.org [2026/04/11 17:40] – supprimée - modification externe (Date inconnue) 127.0.0.1services:admin.chapril.org [2026/04/11 17:40] (Version actuelle) – ↷ Page déplacée de admin:services:admin.chapril.org à services:admin.chapril.org pitchum
Ligne 1: Ligne 1:
 +====== 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>