Je souhaite enrichir la collection de smiley/emoji intégrée à la distribution que je trouve pauvre et mal dessinée.

Par chance, DokuWiki prévoit ce type d'ajout dans son arborescence : clarté et persistence à travers les mises à jour de la distribution.

Sources :

• Smileys (en) (dokuwiki.org). Éviter la version française de cette page, décidément trop pauvre.
• dokuwiki-smileys-local

J'ai trouvé ce que je voulais dans la liste des smiley contributifs présentés sur la page officielle de DokuWiki.

L'ajout se fait en 4 étapes :

1. créer un répertoire dénommé local dans ~/lib/images/smileys/ (~/lib/images/smileys/local/)
2. y téléverser une ou plusieurs collection(s) de smiley (une collection = un répertoire d'images)
3. créer/modifier le fichier smiley.local.conf dans le répertoire ~/conf/
4. effacer le cache¹⁾

J'ai utilisé des collections proposées par davidjimenez75 car elles répondaient à mon besoin.
De plus, elle sont parfaitement packagées et documentées. Le fichier smiley.local.conf est fourni.

La distribution de DokuWiki contient un fichier smiley.conf. Un tel fichier établit une correspondance entre des chaînes de caractères et des fichiers d'images.

Le fonctionnement de DokuWiki permet de remplacer les smiley par défaut. En effet, si le fichier smiley.local.conf associe un autre fichier-image à une chaîne de caractère déjà “définie” dans smiley.conf, la nouvelle association prend le pas.

Cette technique permet de ne pas avoir à toucher aux fichiers de la distribution.
Les mises à jours de DokuWiki n'écrasent pas les fichiers de smyleys additionnels ni le fichier de configuration qui leur correspond.

Plus avant dans la fiche, j'ai mentionné le package de davidjimenez75. Il contient plusieurs collections, un fichier de configuration et un générateur de fichiers de configuration

Une fois le package installé, le fichier de configuration fourni surcharge les smileys préinstallés de DokuWiki par des smileys bien dessinés et ajoute des pictogrammes d'annotation.
Il suffit de le copier/coller dans ~/conf/ et le tour est joué.

Une fois le package installé, on peut supprimer les collections qui ne nous intéressent pas.

Le package contient un script PHP qui permet de générer un fichier de configuration exploitant toutes les collections restantes. On l'utilise comme suit : pointer son navigateur sur l'URL https://mon-dokuwiki/lib/images/smileys/local/index.php dans le “menu” déroulant, choisir l'option “smileys.local.conf” valider ce choix en activant le bouton “search smileys” sélectionner l'intégralité du contenu de la page web qui s'affiche copier cette sélection et la coller dans un fichier texte.

Le fichier ainsi obtenu est un fichier de configuration conforme à ce que doit contenir smileys.local.conf.
On peut :

• le renommer smileys.local.conf et le téléverser dans ~/conf/ (écrasant un éventuel fichier déjà présent)
• utiliser son contenu pour remplacer l’intégralité du contenu d'un fichier ~/conf/smileys.local.conf déjà présent.