Plugin glossaire

Ce plugin intègre le filtre lier_au_glossaire de François Schreuer pour les versions de SPIP supérieures ou égales à 1.9. Vous pouvez voir ce que ça donne par ici.

Caractéristiques

-  le principe général est le même : le filtre parcourt le texte auquel il est appliqué et fait un lien des occurrences du glossaire vers leur définition ;
-  le contenu du glossaire se place dans un groupe de mots-clés nommé « glossaire », chaque mot-clé représente une entrée, et le texte du mot-clé sa définition (au lieu du couple rubrique-brèves) ;
-  seule la première occurrence du mot défini est gérée par le filtre (la contrib permettait de traiter toutes les occurences du même mot dans un même champ) ;
-  un clic sur le mot défini affiche sa définition dans une fenêtre popup (ou renvoie vers le mot-clé correspondant si javascript est inactif ou absent).

Installation

-  Assurez-vous de disposer de la balise #INSERT_HEAD dans les squelettes (livrée en standard dans les squelettes par défaut, cf. doc) ;
-  Décompressez le contenu du zip ci-joint dans le répertoire ’plugins’ de votre site (s’il n’existe pas, créez-le), puis activez le plugin via l’espace privé (Configuration : Gestion des plugins) ;
-  Appliquez le filtre lier_au_glossaire dans les squelettes appropriés — par exemple, [(#TEXTE|lier_au_glossaire)] dans le squelette article.

Recalculez un article contenant au moins une occurrence du glossaire (ou videz le cache). Si le résultat vous satisfait, vous pouvez en rester là. Sinon, option facultative, le dossier du plugin contient trois fichiers modifiables sans risque de tout casser, selon les goûts, les couleurs et les compétences de chacun. Détails et marche à suivre :

Surcharge de fichiers

Il suffit de placer dans votre dossier de squelettes des fichiers du même nom avec vos modifications ou vos ajouts :

-  mot_glossaire.html est le squelette de la fenêtre popup. Elémentaire, il n’affiche que le titre et le texte du mot-clé appelé. Il applique également le filtre lier_au_glossaire au texte du mot-clé : on peut ainsi passer d’une définition à l’autre dans la même fenêtre ;
-  glossaire.css définit les styles du squelette précédent et des liens vers le glossaire ;
-  glossaire.js définit la taille et les éléments de la fenêtre. On peut se contenter d’en modifier les différents attributs, taille, position, ouverture dans la même popup, etc. en faisant attention toutefois de ne pas toucher au premier : ’page’, qui est renseigné par SPIP dans la fonction php.

Il existe une autre version de plugin développée par Philippe Auriol à partir de la contrib de François Schreuer sur SPIP-Zone.
J’ai intégré le bout de code de Philippe qui évite de casser les liens hypertextes mais les deux plugins restent sensiblement différents.

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom