Table des matières

, , ,

Dokuwiki : Problème de génération des formules plugin mathpublish

Problématique

Le plugin (extension) mathpublish a été correctement installé via le gestionnaire d'extensions de Dokuwiki. Dans le gestionnaire, il apparaît sous le nom Math Plugin.

Cependant la formule obtenue ne correspond pas au résultat attendu. L'image générée ne contient que le texte des commandes pas la formule mathématique:

La commande <m>1/x^2</m> produit l'image en lieu et place de la formule attendue

Ce problème s'est présenté lors de l'installation du plugin dans un wiki s'exécutant dans un conteneur Docker (image bitnami/dokuwiki https://hub.docker.com/r/bitnami/dokuwiki).

Les journaux indiquent que des fichiers nécessaires ne sont pas accessibles (inc/init.php):

[Wed Sep 28 00:33:43.071253 2022] [php7:error] [pid 123] [client 172.19.0.2:57862] PHP Fatal error:  require_once(): Failed opening required '/bitnami/dokuwiki/lib/plugins/mathpublish/../../../inc/init.php' (include_path='.:/opt/bitnami/php/lib/php') in /bitnami/dokuwiki/lib/plugins/mathpublish/img.php on line 9, referer: https://wiki.phobos-net.fr/doku.php/software/applications/dokuwiki/depannage/probleme_plugin_mathpublish?do=edit

Résolution

Le problème semble spécifique à l'utilisation du plugin dans le conteneur Docker issu de l'image bitnami/dokuwiki. L'extension mathpublish utilise des chemins relatifs pour accéder aux dossiers inc et vendor mais ces dossiers ne sont pas directement accessibles via un chemin relatif dans le conteneur bitnami/dokuwiki.

Pour les rendre disponibles on peut cependant créer des liens symboliques:

# Invoquer un shell dans le conteneur
docker-compose exec -u root dokuwiki /bin/bash
 
# Créer les liens symboliques
cd /bitnami/dokuwiki/
ln -s /opt/bitnami/dokuwiki/inc/ inc
ln -s /opt/bitnami/dokuwiki/vendor vendor

Après création de ces liens, les formules sont correctement générées dans les pages du wiki.