Citations bien balisées

Pour gérer automatiquement les citations courtes

Ce plugin modifie le traitement du raccourci typographique «<quote>» de SPIP afin de pouvoir produire des citations courtes (moins d’une ligne) plus conformes au HTML.

Ce tout petit plugin est une contribution très simple qui a été inspirée par un billet de tetue publié sur son blog, « Des citations bien balisées », lequel décrypte les spécifications W3C sur le sujet.

Son objectif est de permettre à SPIP de faire la différence entre les citations courtes et longues et d’appliquer le balisage HTML adéquat.

Installation du plugin

Vous trouverez la dernière version du paquet du plugin dans la zone ou ci-dessous :

Citations bien balisées (0.1.6)
Zip du plugin placé sur SPIP-Zone (mis à jour régulièrement)

Dézippez (décompressez) cette archive, puis suivez les instructions traditionnelles pour installer un plugin: Installer un plugin

N’oubliez pas de l’activer...

Citations courtes, longues ??

SPIP permet de faire des citations (originellement pour les forums) grâce au raccourci typographique <quote> comme nous l’indique la documentation pour les rédacteurs.

Quand on écrit «<quote>ceci est une citation courte</quote>», SPIP affiche:

ceci est une citation courte

Ce qui correspond au code HTML suivant: <blockquote class=spip>ceci est une citation courte</blockquote>.

La citation est placée à la ligne, hors du texte, ce qui ne convient pas toujours. En HTML il existe une autre façon de citer que d’utiliser <blockquote> (qui place la citation dans un paragraphe) qui est l’utilisation de <q>.

Le traitement effectué par le plugin

Ce plugin analyse les citations avant que SPIP ne traduise les raccourcis typographiques en HTML. Si la citation tient sur une seule ligne (sans aucun retour à la ligne), il la placera entre des <q> sinon, il laissera SPIP placer des <blockquote>

Le plugin est fourni avec une feuille de style (CSS) minimaliste qui entoure les citations courtes (<q>) par des guillemets typographiques (« et ») et rend la fonte oblique.

Des exemples

Voici quelques exemples de ce qui fait ce plugin.

Une citation courte dans un texte. Voici ce que nous écrivons dans SPIP:

De Proust on connaît évidemment la phrase <quote>Longtemps, je me suis couché de bonne heure…</quote> qui est la première de son œuvre.

Fonctionnement du plugin avec une citation courte
sans le pluginavec le plugin
affichage De Proust on connait évidement la phrase

Longtemps, je me suis couché de bonne heure…

qui est la première de son œuvre.

De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.
Code HTML <p>De Proust on connait évidement la phrase <blockquote>Longtemps, je me suis couché de bonne heure&hellip;</blockquote> qui est la première de son œuvre.</p> <p>De Proust on connait évidement la phrase <q>Longtemps, je me suis couché de bonne heure&hellip;</q> qui est la première de son œuvre.</p>

Une citation de plusieurs lignes:

Voici un Haiku très connu:
<quote>
dans le vieil étang,
_ Une grenouille saute,
_ un ploc de l'eau.
</quote>
de Matsuo Bashō

 [1]

Fonctionnement du plugin avec une citation longue
sans le pluginavec le plugin
affichage Voici un Haiku très connu:

dans le vieil étang,

Une grenouille saute,

un ploc de l’eau.


de Matsuo Bashō

Code HTML
Voici un Haiku très connu&nbsp;:
<blockquote class="spip">
<p>
dans le vieil étang,
<br />Une grenouille saute,
<br />un ploc de l&#8217;eau.</p>
</blockquote>
<p>
de Matsuo Bashō</p>

Footnotes

[1les _ permettent dans le cas de poésies de revenir à la ligne sans paragrapher. Leur usage est déconseillé, il vaut mieux leur préférer le raccourci typographique <poesie>. Dans le cadre de cet exemple, le raccourci <poesie> n’était pas opportun.

Discussion

No discussion

Add a comment

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 / PostgreSQL
  • 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 apparait.

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.

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