FAQ

FAQ

Installation et activation

Le module n'apparaît pas dans la liste des modules Dolibarr

Vérifiez que :

  • Le dossier capdoliwiki est bien placé dans htdocs/custom/ de votre installation Dolibarr
  • La constante $dolibarr_main_document_root_alt dans le fichier conf.php de Dolibarr pointe vers le dossier htdocs/custom (ou le dossier contenant vos modules externes)
  • Votre version de Dolibarr est 18.0 ou supérieure

Le module s'active mais les tables ne sont pas créées

Consultez les logs Dolibarr dans Accueil > Outils système > Journaux. Les erreurs SQL liées à la création des tables y sont consignées. Vérifiez que votre utilisateur de base de données a les droits de création de tables.

Éditeur

L'éditeur ne s'affiche pas (page blanche à la place)

L'éditeur utilise des modules JavaScript ES (ES Modules). Vérifiez que :

  • Votre navigateur est à jour (Chrome, Firefox, Edge ou Safari récent)
  • Les fichiers JavaScript du module sont présents dans le dossier js/ (capdoliwiki-editor.min.js, capdoliwiki-readonly.min.js)
  • Aucun bloqueur de scripts ou extension de navigateur n'interfère avec le chargement

Le collage d'image ne fonctionne pas

Le collage d'image nécessite que l'extension PHP GD soit activée sur votre serveur. Vérifiez sa présence avec phpinfo() ou la commande php -m | grep gd.

Vérifiez également que le dossier de données de Dolibarr est accessible en écriture par le serveur web.

Mon brouillon a disparu

Le brouillon (sauvegarde automatique) est stocké dans le localStorage de votre navigateur. Il est lié au navigateur et au poste de travail utilisé. Si vous changez de navigateur, de poste de travail, ou si vous videz les données de navigation, le brouillon est perdu.

Le brouillon est également supprimé automatiquement après une sauvegarde réussie de la page.

Édition collaborative

Un message m'indique que la page est verrouillée

Un autre utilisateur est actuellement en train de modifier cette page. Vous devez attendre qu'il termine et sauvegarde (ou qu'il quitte la page d'édition) pour pouvoir la modifier à votre tour.

Si l'utilisateur a quitté sans sauvegarder et que le verrou n'a pas été libéré, le verrou expire automatiquement après la durée configurée (30 minutes par défaut).

Un administrateur (permission de suppression) peut forcer le déverrouillage.

Deux utilisateurs peuvent-ils modifier la même page en même temps ?

Non. Le système de verrouillage empêche les modifications concurrentes. Un seul utilisateur à la fois peut ouvrir l'éditeur sur une page donnée.

Contenu

Les diagrammes Mermaid ne s'affichent pas

Les diagrammes Mermaid sont chargés dynamiquement via un fichier JavaScript volumineux (environ 3 Mo). Si votre connexion est lente, le rendu peut prendre quelques secondes.

Vérifiez que le fichier js/capdoliwiki-mermaid.min.js est bien présent dans le dossier du module.

La coloration syntaxique du code ne fonctionne pas

Assurez-vous que le langage est spécifié après les trois backticks d'ouverture du bloc de code. Exemple : ```php pour du code PHP. Sans indication de langage, aucune coloration n'est appliquée.

Les 15 langages pris en charge sont : PHP, JavaScript, Python, Java, C, C++, CSS, HTML, SQL, Bash, JSON, YAML, XML, Markdown et TypeScript.

Export PDF

Les images n'apparaissent pas dans le PDF exporté

Seules les images stockées localement sur le serveur Dolibarr sont incluses dans le PDF. Les images provenant d'URL externes (http/https vers des serveurs tiers) ne sont pas téléchargées pour le PDF.

Les images collées dans l'éditeur via Ctrl+V sont stockées localement et apparaissent normalement dans le PDF.

Le PDF ne contient pas les diagrammes Mermaid

Les diagrammes Mermaid sont rendus côté navigateur en JavaScript. L'export PDF utilise une conversion Markdown vers HTML simplifiée côté serveur qui ne prend pas en charge les diagrammes Mermaid.

Corbeille

Comment restaurer une page supprimée ?

  1. Accédez à la liste des pages wiki (ECM/GED > Wiki)
  2. Cliquez sur le lien Voir la corbeille en bas de page
  3. Repérez la page à restaurer
  4. Cliquez sur l'icône de restauration et confirmez

Cette action nécessite la permission de suppression/administration.

Les pages de la corbeille disparaissent automatiquement

La tâche planifiée PurgeWikiTrash supprime définitivement les pages en corbeille dont la date de suppression dépasse la durée de rétention configurée (30 jours par défaut). Vous pouvez ajuster cette durée dans la configuration ou la mettre à 0 pour désactiver la purge automatique.

Support

Pour toute question non couverte par cette documentation :

Permissions