Dictionnaires

31 October 2013 – by b_b, claudeD, RastaPopoulos – 68 commentaires

1
2
3
4
5
16 Votes

Table of contents

Présentation

Le plugin Dictionnaires sert à définir des choses, regroupées dans des dictionnaires. Une définition peut avoir plusieurs statuts comme les articles, tandis qu’un dictionnaire peut juste être actif ou inactif. Lorsqu’un dictionnaire est activé, cela signifie que ses définitions seront cherchés dans tous les textes du site.

Par défaut, deux types de définitions sont disponibles : normale ou abréviation (sigle, acronyme ou autre).

Chaque définition peut lister des termes supplémentaires qui seront reconnus aussi (le pluriel par exemple). Pour les abréviations, le système ajoute automatiquement une version avec p.o.i.n.t.s, il n’est dont pas nécessaire de les ajouter vous-mêmes.

Un plugin proche existe : le plugin Glossaire mais SPIP a tendance à mouliner lorsque la liste des définitions (un groupe de mots-clés) est trop importante. Moins proche et entièrement manuel, le raccourci Wikipedia de SPIP : [?Wikipedia].

L’avantage du plugin Dictionnaires est qu’il demande moins de ressources et qu’il présente deux nouveaux objets qui suivent l’analogie Rubriques/Articles et peuvent chacun recevoir des logos et des documents.

Fonctionnement

Lorsqu’un dictionnaire est actif, toutes ses définitions publiées sont recherchées dans les textes qui passent par la fonction propre(). Les termes trouvés sont alors remplacés par une fonction personnalisable (cette fonction est aussi personnalisable suivant le type de définition).

La fonction par défaut ajoute un lien “Définition” en note <sup> après le mot, lien qui pointe vers la page de la définition (pour info, le plugin fournit des squelettes compatibles avec Zpip pour afficher une définition et un dictionnaire).

Ce comportement n’est fait que pour les premières occurrences de chaque texte. Ceci est personnalisable depuis la page de configuration du plugin.

Une option “sensible à la casse” est disponible pour chaque définition. Ceci indique au détecteur de prendre en compte uniquement le terme exact (“ce” ne sera pas reconnu pour “CE”).

Pour chaque dictionnaire, vous pouvez définir le type par défaut des nouvelles définitions qui y seront crées.

Lors de l’installation, le plugin propose une fonction d’importation des acronymes définis à l’aide du plugin Forms&Tables. Les éléments sont importés en tant qu’abréviations (modifiable ensuite).

Installation du plugin

L’installation se fait par la méthode habituelle, Dictionnaires ne demande que le plugin Saisies comme plugin complémentaire pour fonctionner.

Configuration du plugin

Une fois l’installation faite, le menu “Configuration” de SPIP affiche un item “Dictionnaires”.

Par ce lien, vous arrivez à la page “Configurer les dictionnaires” qui propose deux cases déjà cochées :

  • Remplacer uniquement la première occurrence d’une définition
  • Remplacer uniquement la première occurrence d’une abréviation

Cela vous permet d’afficher les définitions sur tous les termes d’un texte ou seulement la premier fois qu’ils sont rencontrés.

La constante define('DICTIONNAIRES_DETECTION_MANUELLE', true); permet de spécifier que l’auteur des squelettes se charge d’appliquer le filtre |definitions sur les balises souhaitées, et non sur tout les textes qui passent par la fonction propre().

Saisie des dictionnaires

Il faut d’abord créer un ou des dictionnaires et, pour chacun, créer des définitions. Le menu «Édition» de SPIP contient aussi une entrée «Dictionnaires». Il vous suffit de cliquer sur «Ajouter un nouveau dictionnaire».

Liste des champs pour l’objet Dictionnaire :

  • Titre (champ obligatoire)
  • Descriptif (champ)
  • Abréviation par défaut (case à cocher)

Cet objet a deux statuts possibles : Inactif (par défaut)/Actif. Un dictionnaire actif aura ses termes détectés dans les contenus du site.

Accessoirement, le plugin permet d’utiliser un raccourci supplémentaire : [mon texte->dictionnaireXXX].

Saisie des définitions

Une fois un dictionnaire créé, sa page de “vue” propose d’ajouter des définitions.

Cliquer sur «Ajouter une nouvelle définition» donne une liste de champs pour l’objet Définition :

  • Titre (champ obligatoire)
  • Dictionnaire (menu déroulant, obligatoire)
  • Texte (champ)
  • Termes (champ listant “Des termes supplémentaires qui permettront de détecter la définition, séparés par des virgules.”) [1]
  • Abréviation (case à cocher, «Est-ce un sigle, un acronyme ou autre abréviation ?»)
  • Sensibilité à la casse (case à cocher : «La détection de ce terme sera sensible aux minuscules et majuscules.»)

Cet objet a trois statuts possibles : «proposé à l’évaluation» (par défaut)/«publié en ligne»/«à la poubelle».

La date de création d’une définition ne peut être modifiée que sous le statut «publié en ligne».

Accessoirement, le plugin permet — ici aussi — d’utiliser un raccourci supplémentaire : [mon texte->definitionXXX].

Utilisation dans vos squelettes

Comme cité plus haut, le plugin fournit des squelettes compatibles avec Zpip pour afficher une définition et un dictionnaire. Vous pouvez consulter ces squelettes dans le répertoire contenu du plugin.

Le plugin met aussi aussi à disposition deux modèles utilisables depuis vos squelettes ou le texte de vos pages :
-  <dictionnaires> affiche la liste des dictionnaires
-  <dictionnaire> affiche la liste des définitions d’un dictionnaire.

Les balises de l’objet «dictionnaire» sont :

  • #ID_DICTIONNAIRE
  • #URL_DICTIONNAIRE
  • #LOGO_DICTIONNAIRE
  • #TITRE
  • #DESCRIPTIF

Les balise de l’objet «definition» sont :

  • #ID_DEFINITION
  • #URL_DEFINITION
  • #LOGO_DEFINITION
  • #TITRE
  • #TEXTE
  • #TERMES
  • #INTRODUCTION

Footnotes

[1] Par exemple, pour la définition « Dioïque », vous pouvez aussi lister les termes : dioïques, dioïcie ; pour la définition « Tomenteux », les termes, tomenteuse, tomenteuses…

updated on 2 October 2019

Discussion

5 ans 1 an 3 mois Sans limite
Last published
Filtrer

21 discussions

  • thx11

    Bonjour,

    Plugin très utile, bravo!
    Je suis en spip 3.1 et je souhaiterai faire apparaître en bas de l’article (façon notes) le récaptitulatif des définitions utilisées plus haut dans ce même article.
    Je sèche sur la boucle à utiliser ?
    Merci pour votre aide

    Reply to this message

  • 3
    spipfactory

    Dans cette page http://nature-en-tarentaise.org/spip.php?article109&lang=fr
    Sauter le premier paragraphe et aller jusqu’à l’énumération au deuxième paragraphe. Dans le premier terme de l’énumération il y a le mot “panicule”, dans le deuxième terme il y a les mots “épillets”, “mutique”, on voit un petit point d’interrogation qui indique qu’il y a une définition.
    1- Cette présentation avec un point d’interrogation est pas top. Souligné ou des couleurs, ce serait compréhensible...(je suis sur que c’est possible, mais qu’il me manque un truc)
    2- Si je passe la souris dessus j’ai le début de la définition qui apparaît dans un cadre, peut être on peut dire qu’on veut la définition entière...
    3- Si je clique sur le point d’interrogation j’ai affichage de la page d’erreur 404 car il n’y a pas le squelette des définitions...

    J’espère que c’est compréhensible !
    Merci et bonne journée à tous.

    • Philippe Pellicier

      Bonjour,
      Je vois que ce message n’a pas eu de réponse. Pourtant ce qui est décrit correspond bien à ce qui se passe sur le site en question. Et je n’ai pas trouvé de solution.
      Si vous avez une idée à suggérer pour trouver une solution.
      Merci

      Philippe Pellicier

    • RastaPopoulos

      Bah vous avez 404 parce que vous n’avez pas de squelettes dédiés à cet objet (“definition”), ça doit le dire dans le message d’ailleurs normalement. Le plugin fournit des squelettes dans “contenu” mais il faudrait le changer en “content” car c’est vieux comme le monde “contenu”, maintenant tous les trucs qui utilisent z-core utilisent “content”. Mais si vous n’êtes pas en format Z ça peut toujours s’inclure dans un definition.html à vous à la racine.

      Pour ce qui est du lien, c’est fait exprès que ce ne soit pas sur le mot par défaut, mais bien un lien extérieur qui suit. Ça pourrait sûrement être plus long et plus accessible (le mot “définition” carrément ou bien “déf” avec un abbr dessus).

      Par contre dans tous les cas on peut personnaliser le rendu par défaut, et aussi le rendu par type de définition (abréviation etc).

      C’est la fonction “dictionnaires_remplacer_defaut_dist” qui est là :
      http://zone.spip.org/trac/spip-zone/browser/_plugins_/dictionnaires/trunk/inc/dictionnaires.php#L173
      et qui peut donc être surchargée en enlevant le “_dist” à la fin.

      Ou bien comme expliqué juste en-dessous, en ajoutant une fonction plus précise : “dictionnaires_remplacer_abbr_dist” par exemple, pour CE type de définition.

      (Oui cette partie de fonctions personnalisables n’est pas dans la doc : c’est mal.)

      Normalement vous devriez avoir tout pour personnaliser le rendu comme voulu.

    • claudeD

      oui, comme le dit RastaPopoulos, il manque un squelette definition.html mais aussi un squelette dictionnaire.html pour cet autre 404 :
      http://nature-en-tarentaise.org/spip.php?dictionnaire1

    Reply to this message

  • 4
    Gilles

    Bonjour,
    Est-ce qu’il existe #URL_EXTERNE pour utiliser dans les squelettes ?
    Merci !

    Reply to this message

  • 2
    perig

    Bonjour,
    Je viens d’effectuer la mise à jour du plugin SAISIES de 2.5.18 vers 2.5.20 et je rencontre un bug avec la page définition.

    Quand je souhaite modifier une définition (“exec=definition_edit”), j’obtiens des “1” dans tous les champs. Et si j’enregistre, c’est bien-sûr la cata. Tous mes champs sont effacés et remplacés par des “1”.

    Par contre, pour l’enregistrement d’une nouvelle définition, tout fonctionne normalement.

    (Avec Dictionnaires V1.1.2).

    Amicalement.

    Reply to this message

  • 2
    Aymeric

    Bonjour,

    Ce plugin s’avère très utile mais je n’ai pas trouvé comment l’empêcher de couper les libellés (à 75 caractères je crois).

    Il se trouve que je dois faire face à de très longs acronymes :)

    Merci de votre aide.

    Reply to this message

  • 6
    freedfromparis

    Bonjour,

    J’ai constaté une anomalie sur un de nos sites en utilisant la version 1.0.4, lorsque l’on créé une définition dont le titre possède un accent ça plante le site en front office et affiche cette erreur :

    Warning: preg_replace_callback() [function.preg-replace-callback]: Compilation failed: invalid UTF-8 string at offset 22 in /xxx/plugins/_externals/dictionnaires/dictionnaires_fonctions.php on line 50

    Je suis en SPIP 3.0.19 et j’utilise une surcharge des filtres dictionnaires_remplacer_defaut et dictionnaires_remplacer_abbr de cette manière :

    function dictionnaires_remplacer_defaut($mot, $definition) {
        if (!isset($definition['url']) OR !$url = $definition['url']) {
                $url = generer_url_entite($definition['id_definition'],'definition');
        }
  
  return "<abbr class="popoverLink" rel="popover" data-toggle="popover" data-placement="top" data-html="true" title="".trim(attribut_html(supprimer_tags(typo($definition['titre']))))."" data-container="body" data-content="".htmlspecialchars(propre($definition['texte']), ENT_QUOTES)."">".$mot."</abbr>";
  
}

function dictionnaires_remplacer_abbr($mot, $definition){
        return "<abbr class="popoverLink" rel="popover" data-toggle="popover" data-placement="top" data-html="true" title="".trim(attribut_html(supprimer_tags(typo($definition['titre']))))."" data-container="body" data-content="".htmlspecialchars(propre($definition['texte']), ENT_QUOTES)."">".$mot."</abbr>";
}

    Ce problème je ne le constate pas sur un SPIP de base, j’en déduis qu’il s’agit d’une particularité de notre site.

    Si vous avez une idée... merci d’avance :)

    Freed

    • RastaPopoulos

      J’ai ajouté une option (u) aux regex pour mieux prendre en compte les accents (suite à une discussion sur ce forum) :
      http://zone.spip.org/trac/spip-zone/changeset/88279

      La doc dit :

      Cette option désactive les fonctionnalités additionnelles de PCRE qui ne sont pas compatibles avec Perl. Les chaînes sont traitées comme des chaînes UTF-8. Cette option est disponible en PHP 4.1.0 et plus récent.

    • freedfromparis

      Bonjour RastaPopoulos,
      Merci pour cet update du plugin, cependant en le testant j’obtiens la même erreur :(

      Warning: preg_replace_callback() [function.preg-replace-callback]: Compilation failed: invalid UTF-8 string at offset 22 in /xxx/plugins/_externals/dictionnaires/dictionnaires_fonctions.php on line 50
    • RastaPopoulos

      Non mais le plugin n’a pas bougé, c’est une modif qui date d’il y a 4 mois et qui justement pourrait être en rapport avec ton erreur.

    • b_b

      Le problème que tu décris ressemble pas mal à celui corrigé ici :

      http://zone.spip.org/trac/spip-zone/changeset/91004/

      Tu as testé avec la version 1.0.5 ?

    • freedfromparis

      Oui je suis passé en 1.0.5 ce matin pensant qu’il s’agissait d’une correction du problème

      Le lien que tu viens de me donner semble bien correspondre à un des contats de mon problème (ces symptômes se produisaient en production seulement)

      Autre info :
      J’obtiens ces erreurs de preg_replace_callback en environnement de développement et recette
      En production j’avais pas d’erreurs affichées (peut-etre que l’environnement n’affiche pas les erreurs PHP) mais tous les textes disparaissaient.
      En local (XXAMP) je n’ai pas d’erreur, ni de disparition de texte, en revanche lorsque j’ai un terme avec un accent il semble ne pas être traité

    • freedfromparis

      Re-bonjour,

      Finalement en ayant livré la nouvelle version du plugin en production (1.0.5) le problème de textes vides était toujours présent, en réalité les erreurs PHP n’étant pas affichées en prod, nous ne voyions pas le problème qui finalement était le même (preg_replace_callback)

      Nous avons choisi de désactiver le filtre |definitions sur les textes en attendant de trouver une solution

      PS : notre serveur de production est en PHP 5.4.40 , je ne sais pas si ça peut jouer sur quelque chose.

      Merci

    Reply to this message

  • 2
    freedfromparis

    Bonjour,
    Je rencontre un souci avec ce plugin lorsque je tente d’afficher une liste d’articles avec pagination en AJAX et qu’un terme provenant du dictionnaire se trouve dans la balise #INTRODUCTION (c’est à dire en début de texte quoi)
    J’obtiens un “Aborted” sur l’url appelée.
    Existe-t-il un filtre qui désactive le dictionnaire volontairement sur certains textes ?

    Merci d’avance.
    Freed

    • RastaPopoulos

      La balise #INTRODUCTION passe par propre(), donc par la détection auto des définitions.

      Mais je ne saurais pas dire pourquoi en ajax ça ferait tout planter, ya pas de raison immédiate qui me vient à l’esprit. Peut-être qu’il faudrait détecter qu’on est dans un hit ajax (il me semble qu’il y a une globale ou un truc pour savoir ça) et ne pas lancer la machinerie dans ce cas. Mais bon yorait pas vraiment de raison de faire ça, un même contenu aurait alors des fois des définitions, des fois pas, suivant s’il est chargé en ajax ou pas, ce n’est pas très cohérent…

      Faudrait surtout comprendre pourquoi ça plante. :(

    • freedfromparis

      J’avais corrigé le problème en utilisant define(’DICTIONNAIRES_DETECTION_MANUELLE’, true); et en appliquant le filtre |definitions uniquement sur les textes complets.

      C’est un peu contourner le problème mais pas besoin d’avoir des définitions dans des listes selon moi.

    Reply to this message

  • 7
    Philippe B.

    Bonjour,

    Si j’ajoute le mot Marche dans un dictionnaire, le plugin fait un lien par exemple sur une partie du mot dé[marche]. Si j’enlève le é, ce mot n’est pas impacté...

    Voici un exemple du problème sur cette article (dans le paragraphe la cane de Montfort au 19e siècle):
    -  > http://broceliande.brecilien.org/La-cane-de-Montfort-dans-les-traditions-populaires

    Quelqu’un rencontre-t’il ce phénomène ?

    Merci de plugin génial !

    • RastaPopoulos

      Oui c’est très bizarre, comme si la lettre accentuée était reconnu comme étant un caractère “hors-mot”.

      Le masque de recherche est généré ici :
      http://zone.spip.org/trac/spip-zone/browser/_plugins_/dictionnaires/trunk/inc/dictionnaires.php#L113

      Chaque masque DOIT débuter par [^\w@\.] càd PAS (^) un caractère de mot (\w) ni un arobase ni un point. La lettre accentuée est donc reconnue comme compatible avec ce truc, ce qui n’est pas normal (un problème de charset ?).

      Si tu es très fort en expression rationnelle ou si tu connais quelqu’un qui est très fort, je veux bien un indice parce que pour l’instant moi je ne vois pas. :(

    • claudeD

      j’ai essayé chez moi avec diverses lettres accentuées, je n’arrive pas à reproduire.

      SPIP 3.1.0-alpha — utf-8

      bibliothèque MySQL (5.0.51a) - serveur MySQL (5.5.41)

      interclassement utf8_general_ci

    • RastaPopoulos

      Si Claude n’arrive pas à reproduire, ça irait donc peut-être bien dans le sens d’un problème d’encodage, de charset chez Philippe.

    • b_b

      Un test rapide sur https://regex101.com/ me montre que l’expression capture bien le caractère accentué de démarche. En ajoutant la modifieur u après la regex cela semble mieux.

      u modifier: unicode: Pattern strings are treated as UTF-16. Also causes escape sequences to match unicode characters

      Mais \w est locale-dependent : pour de l’UTF-8, ça implique le modificateur u sinon un setlocale préalable (encore faut-il que cette locale système soit disponible et active).

    • RastaPopoulos

      Philippe tu peux tester si en ajoutant “u” après le “s” à la fin du masque ça marche chez toi ? À l’endroit que j’ai pointé plus haut, la fin est ligne 122 :
      http://zone.spip.org/trac/spip-zone/browser/_plugins_/dictionnaires/trunk/inc/dictionnaires.php#L122

    • Philippe B.

      OK ça marche !

      Merci pour votre réactivité !

      Pour info, je suis sur SPIP 3.0.17 utf8, mySQL 5.5.41 interclassement utf8_general_ci.
      A noter que j’utilise le plugin Full Text.

    • RastaPopoulos

      Voilà j’ai commité sur les deux versions du plugin Philippe :
      http://zone.spip.org/trac/spip-zone/changeset/88279

    Reply to this message

  • 2
    erational

    A noter que le plugin permet de surcharger la sortie HTML

    Même s’il s’agit d’une mauvaise pratique en terme d’accessibilité de placer du contenu dans l’attribut title.

    Voici un exemple pour afficher la définition dans le titre d’un lien (pour réaliser une info-bulle type “tooltip”),
    on pourra ajouter dans mes_fonctions.php

    function dictionnaires_remplacer_defaut($mot, $definition) {
	if (!isset($definition['url']) OR !$url = $definition['url']) {
		$url = generer_url_entite($definition['id_definition'],'definition');
	}
 
  return "<a class='tooltip' href='#' title='".trim(attribut_html(supprimer_tags(typo($definition['texte']))))."'>".$mot."</a>";
 
}
    • RastaPopoulos

      Premièrement, il est possible de remplacer uniquement un seul type de définition, par exemple que les “abbr” :

      1. function dictionnaires_remplacer_abbr_dist($mot, $definition)

      Et deuxièmement, attention à ce que dit le commentaire dans le code, et qu’il faudrait que je rajoute dans la documentation :

      Fonction de remplacement par défaut pour les abréviations trouvées dans les textes
      Ceci est un EXEMPLE montrant qu’on peut mettre un truc différent pour un type de définition précis
      Mais ce code est une MAUVAISE PRATIQUE en accessibilité
      (car seuls les gens avec des yeux valides et un pointeur de souris ont accès à l’information

      Au niveau accessibilité, il ne faut pas que l’information se trouve uniquement dans le title.

      • Soit il faut un lien vers une autre page contenant la définition (une page par définition ou bien une grande page avec une ancre sur la bonne définition).
      • Soit il faut que les définitions se trouve dans la page courante, et qu’il y ait un lien pointant vers l’ancre de la bonne définition, exactement comme les notes de bas de page, par exemple. Après en javascript, on peut utiliser ces définitions de la page courante pour générer des infobulles, mais c’est une amélioration progressive en plus, qui vient après coup (tout comme il existe des JS pour afficher les notes de bas de page en infobulle, comme le plugin de b_b).
    • erational

      Tu as raison ^^.

      Pour des info-bulles, on m’a signalé le plugin bigfoot plus respectueux en accessibilité.

    Reply to this message

  • Yohooo

    Je m’en suis sorti par une boucle recherche.
    Cela nécessite le plugin “Recherche Fulltext”.

    1. J’ai ajouté un fichier nommé “inc_recherche” dans mon squelettecontenant le code suivant :

    <BOUCLE_recherch(ARTICLES){recherche}{! par points}>
<a class="bloc spip_in" href="#URL_ARTICLE">#TITRE</a>
</BOUCLE_recherch>

    2. J’ai ajouté ces 2 lignes dans ma page :

    <INCLURE{fond=inc_recherche}{recherche="#TITRE"}>
<INCLURE{fond=inc_recherche}{recherche="#TERMES|replace{',' , '" "'}|concat{'"'}}>

    Je ne doute pas que tout cela soit perfectible, mais c’est une solution rapide.

    En parcourant le forum du plugin Fulltext, je me suis d’ailleurs aperçu qu’un autre développeur faisait le lien entre ces 2 plugins

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom