Les modèles SPIP sont très différents les uns des autres. On a, par exemple :
- des modèles qui n’ont pas de balise fermante (comme par exemple la balise :
<img>
) - des modèles qui ont une balise fermantes (comme par exemple la balise :
<cadre>...</cadre>
) - des modèles dont les paramètres utilisent une syntaxe avec le pipe (comme par exemple la balise :
<imgXX|left>
) - des modèles dont les paramètre utilisent une syntaxe html (comme par exemple la balise :
<cadre class="javascript">...</cadre>
)
Configuration
CKEditor étant un éditeur WYSIWYG, le plugin CKEditor pour SPIP se devait de permettre d’utiliser ces balises sans en connaître les particularités.
Pour cela, l’administrateur doit utiliser l’onglet « Configuration des modèles SPIP »
Tout commence par la création d’un « Nouveau modèle », SPIP demande alors le nom du modèle, il faut que ce soit le nom de la balise que l’administrateur compte permettre à ses rédacteurs d’utiliser dans CKEditor, par exemple : cadre pour utiliser le modèle SPIP <cadre>
.
Ce modèle sera disponible dans CKEditor via une liste déroulante, l’administrateur doit préciser comment apparaîtra ce modèle dans la liste. C’est l’objet des deux champs :
- « Intitulé dans la liste déroulante »,
- « Description du modèle » (c’est à dire, le contenu de la bulle d’aide).
Ensuite, il doit indiquer si le modèle est numérique. Par exemple, pour une image, on précisera : modèle « numérique », puis que cette valeur représente « un document ». De cette façon le plugin, proposera une liste des identifiants des documents SPIP (avec leur nom).
Enfin, on précise si le modèle est un modèle à balise fermantes. Comme les modèles à balises fermantes ont un contenu, et que ce contenu sera interprété par SPIP lors de la réédition du texte [1], il faut préciser au plugin si on doit protéger le contenu de cette interprétation en protégeant certains caractères (le plus simple est de protéger : {}[]
.
Reste à configurer la façon dont devront être gérés les paramètres des modèles.
Paramètres des modèles
La première chose à configurer, c’est la syntaxe avec laquelle ces paramètres devront être insérés par le plugin :
- soit la syntaxe
spip
, exemple :<sjcycle16|center|docs=101,102,103,104|id_diapo=1>
, - soit la syntaxe
html
, exemple :<cadre class="spip">...</cadre>
Le plugin permet ensuite de configurer des listes de paramètres sélectionnables que le rédacteur pourra utiliser au lieu de connaître tous les paramètres de la balise.
Il suffit d’ajouter à la liste tous les paramètres que l’administrateur souhaite proposer à ses rédacteurs. Puis pour chaque paramètre, il faut indiquer la listes des valeurs qui peuvent être documentées pour les rédacteurs. Il suffit donc d’ajouter chaque valeur, puis l’intitulé sous lequel cette valeur apparaîtra dans la liste déroulante proposant les valeurs.
Exemples :
Un bon (espérons-le) dessin valant mieux qu’un long discours ...
Le modèle <cadre>
Dans la configuration vous entrez :
Ce qui permet d’obtenir dans la barre d’outils de CKeditor :
Puis, la boite de dialogue suivante :
PS : les dernières versions ont une interface de configuration légèrement différente.
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
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.
Suivre les commentaires : |