Modèle:Citation bloc/Documentation

Ceci est la page de documentation de Modèle:Citation bloc [modifier] [purger].
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Ce modèle utilise le module Citation bloc, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le Projet:Scribunto si vous voulez en savoir plus.

1 Utilisation

Les modèles {{Citation bloc}}, {{Début citation}} et {{Fin citation}} servent à insérer dans un article une citation, en retrait du texte, avec son auteur (et l’ouvrage de référence).

Attention, ces modèles ne doivent pas être utilisés pour des citations courtes (moins d’une ligne). Pour plus d’informations, voir Wikipédia:Citation.

2 Incompatibilités

Un inconvénient de {{citation bloc}} est qu'il ne fonctionne pas si les signes « = » (égal) ou « | » (barre verticale) sont inclus dans la citation. Pour les insérer correctement, il faut utiliser les modèles {{!}} et {{=}} qui permettent l'affichage de ces caractères sans poser de problèmes.

Un autre inconvénient de {{citation bloc}} est qu'il n'accepte pas les listes à puces et les listes numérotées.

Il faut donc préférer {{Début citation}} et {{Fin citation}} dans la conception d'un modèle.

2.1 Signes

Exemples :

• Avec {{citation bloc}} :

{{citation bloc|Les signes = et | sont dangereux.}}

« sont dangereux. »

• Avec {{citation bloc}}, {{=}} et {{!}} :

{{citation bloc|Les signes {{=}} et {{!}} sont dangereux.}}

« Les signes = et | sont dangereux. »

• Avec {{début citation}} :

{{début citation}}Les signes = et | sont dangereux.{{fin citation}}

« Les signes = et | sont dangereux. »

2.2 Listes à puces

{{début citation}}
Liste à puces :
* liste ;
* à ;
* puces.

Liste numérotées :
# Liste.
# Numérotée.

Fin du texte.
{{fin citation}}

«  Liste à puces :

• liste ;
• à ;
• puces.

Liste numérotées :

1. Liste.
2. Numérotée.

Fin du texte.  »

3 Syntaxe

Ce modèle sert à insérer dans un article une citation, en retrait du texte, avec son auteur (et l’ouvrage de référence). Dans le cas d’une citation courte, il vaut mieux utiliser le modèle « Citation ».

Paramètres du modèle

Paramètre		Description	Type	Statut
Citation	1	Contenu de la citation : le texte mis entre guillemets.	Chaîne	obligatoire
Auteur	2	Nom de l’auteur de la citation	Chaîne	facultatif
Ouvrage	3	Titre de l'ouvrage dans lequel on peut trouver cette citation	Chaîne	facultatif
Style	style align	Si ce paramètre vaut « center », le texte est centré.	Chaîne	facultatif
Référence	référence	Permet d'ajouter une référence juste après le guillemet fermant Exemple <ref>auteur, ''titre'', lieu, éditeur, date, ISBN, page</ref>	Contenu	facultatif
Dans une liste	dans une liste	permet de mettre une citation dans une liste, ou un message indenté Par défaut non pour les articles oui sur les espaces de discussions Exemple oui	Booléen	facultatif

{{Citation bloc|citation|auteur|ouvrage|référence=|dans une liste=|style=center}}

• citation : la citation proprement dite sans les guillemets (obligatoire).
• auteur : son auteur (optionnel, vierge par défaut).
• ouvrage : l’ouvrage de référence (optionnel, vierge par défaut).
• référence : référence complète de l'ouvrage entre balise ref (optionnel, vierge par défaut).
• dans une liste : génère un code sur une seule ligne qui permet de l'insérer dans une liste ou un message indenté. Par contre cela dégrade l'affichage des liste au sein de ces citations (optionnel, non par défaut dans les espaces encyclopédique, oui par défaut dans les espaces de discussion).
• style=center : centrage du contenu de la citation (optionnel).

{{Début citation}}citation{{Fin citation|auteur|ouvrage}}

• citation : la citation proprement dite sans les guillemets (obligatoire).
• auteur : son auteur (optionnel, vierge par défaut).
• référence : l’ouvrage de référence (optionel, vierge par défaut).

4 Notes

Les retours à la ligne sont pris en charge dans le modèle {{Citation bloc}}. Par exemple, le code :

{{Citation bloc|La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. 

Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise.}}

Donne comme résultat :

« La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole.

Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. »

En revanche, ce n'est le cas avec les modèles {{Début citation}} et {{Fin citation}} que s'il y a au moins trois paragraphes dans la citation. S'il n'y a que deux paragraphes, ils seront fusionnés en un seul.

5 Exemples avec {{Citation bloc}}

Code wiki	Rendu
Texte témoin.{{Citation bloc|La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » Texte témoin.
Texte témoin.{{Citation bloc|La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.|Pierre Bourgault}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » — Pierre Bourgault Texte témoin.
Texte témoin.{{Citation bloc|La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.|Pierre Bourgault|La Culture – Écrits polémiques<ref name="Bourgault1">Pierre Bourgault, ''La Culture – Écrits polémiques'', éd. PCL, 1996, {{t.| II}}, {{p.|135}}.</ref>.}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » — Pierre Bourgault, La Culture – Écrits polémiques. Texte témoin.
Texte témoin.{{Citation bloc|La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.|référence=<ref name="Bourgault1"/>.}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. ». Texte témoin.
Texte témoin.{{citation bloc|Je veille aux portes du ciel avec l'aimable cortège des Heures; Jupiter ne peut entrer ni sortir sans moi : c'est pour cela qu'on m'appelle Janus.|Ovide|style=center}}{{citation bloc|{{la}} quod ab eundo nomen est ductum : dont le nom ''allant'' dérive.|Cicéron}}Texte témoin.	Texte témoin. « Je veille aux portes du ciel avec l'aimable cortège des Heures; Jupiter ne peut entrer ni sortir sans moi : c'est pour cela qu'on m'appelle Janus. » — Ovide « (la) quod ab eundo nomen est ductum : dont le nom allant dérive. » — Cicéron Texte témoin.
# Texte témoin. {{Citation bloc|citation au sein d'une liste|dans une liste=oui}} # Texte témoin. # Texte témoin. {{Citation bloc|citation qui casse la liste|dans une liste=non}} # Texte témoin.	Texte témoin. « citation au sein d'une liste. » Texte témoin. Texte témoin. « citation qui casse la liste. » Texte témoin.
Texte témoin. {{Citation bloc|citation * qui contient * une liste|dans une liste=non}} Texte témoin. {{Citation bloc|citation * qui contient * une liste|dans une liste=oui}} Texte témoin.	Texte témoin. « citation qui contient une liste. » Texte témoin. « citation * qui contient * une liste. » Texte témoin.

6 Exemples avec {{Début citation}} et {{Fin citation}}

Code wiki	Rendu
Texte témoin.{{Début citation}}La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.{{Fin citation}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » Texte témoin.
Texte témoin.{{Début citation}}La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.{{Fin citation|Pierre Bourgault}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » — Pierre Bourgault Texte témoin.
Texte témoin.{{Début citation}}La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent.{{Fin citation|Pierre Bourgault|La Culture – Écrits polémiques<ref name="Bourgault2">Pierre Bourgault, ''La Culture – Écrits polémiques'', {{t.|II}}, éd. PCL, 1996, {{p.|135}}.</ref>.}}Texte témoin.	Texte témoin. « La parole est vaine pour les imbéciles. C’est pourquoi il ne faut pas leur en laisser le monopole. Il faut que l’intelligence parle mieux et plus haut que la stupidité, que le préjugé, que l’ignorance, que la bêtise. Elle n’est pas que plaisir. C’est aussi une arme dangereuse qu’il faut savoir maîtriser pour ne pas se laisser maîtriser par ceux qui la maîtrisent. » — Pierre Bourgault, La Culture – Écrits polémiques. Texte témoin.

7 Exemples incluant le modèle {{Ouvrage}}

Code wiki	Rendu
Texte témoin.{{Citation bloc|On ne réclamait plus seulement le droit du peuple à ne plus être opprimé, mais le droit du peuple à ne plus opprimer lui-même.|{{Ouvrage|langue=français|auteur1=François Maspero|titre=Le droit à l'insoumission, le dossier des 121|lieu=Paris|éditeur=François Maspero|date=1961|titre chapitre=Avertissement de l'éditeur}}}}Texte témoin.	Texte témoin. « On ne réclamait plus seulement le droit du peuple à ne plus être opprimé, mais le droit du peuple à ne plus opprimer lui-même. » — François Maspero, Le droit à l'insoumission, le dossier des 121, Paris, François Maspero, 1961, « Avertissement de l'éditeur » Texte témoin.
Texte témoin.{{Début citation}}On ne réclamait plus seulement le droit du peuple à ne plus être opprimé, mais le droit du peuple à ne plus opprimer lui-même.{{Fin citation|{{Ouvrage|langue=français|auteur1=François Maspero|titre=Le droit à l'insoumission, le dossier des 121|lieu=Paris|éditeur=François Maspero|date=1961|titre chapitre=Avertissement de l'éditeur}}}}Texte témoin.	Texte témoin. « On ne réclamait plus seulement le droit du peuple à ne plus être opprimé, mais le droit du peuple à ne plus opprimer lui-même. » — François Maspero, Le droit à l'insoumission, le dossier des 121, Paris, François Maspero, 1961, « Avertissement de l'éditeur » Texte témoin.