Modèle:Citation bloc/Documentation
| Notice | Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement. |
| Notice | 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. |
Sommaire
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.
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.
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. »
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 :
- Liste.
- Numérotée.
Fin du texte. »
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è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
| Contenu | facultatif |
| Dans une liste | dans une liste | permet de mettre une citation dans une liste, ou un message indenté
| 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).
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.
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.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.
— 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.
— Pierre Bourgault, La Culture – Écrits polémiques[1]. 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.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.
— Cicéron Texte témoin. |
|
|
« citation qui casse la liste. »
|
|
|
Texte témoin. Texte témoin. Texte témoin. |
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.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.
— 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.
— Pierre Bourgault, La Culture – Écrits polémiques[2]. Texte témoin. |
- ↑ Aller à : 1,0 et 1,1 Pierre Bourgault, La Culture – Écrits polémiques, éd. PCL, 1996, t. II, p. 135.
- ↑ Pierre Bourgault, La Culture – Écrits polémiques, t. II, éd. PCL, 1996, p. 135.
Voir aussi
- Pages de recommandations sur les citations
- Autres modèles
- Modèles {{Début citation}} et {{Fin citation}} : pour les citations longues dans un bloc indentable, équivalents à {{Citation bloc}}.
- Modèle {{Citation}} : pour les citations en français, intégrées dans le corps de texte
- Modèle {{Langue}} : pour les mots ou phrases en langue étrangère
- Modèle {{Citation bilingue bloc}} : pour mettre cote-à-cote une citation en langue étrangère et sa traduction en français
- Modèle {{Citation étrangère bloc}} : pour les citations en langue étrangère séparées du corps du texte.
- Modèle {{Aphorisme}}
- Modèle {{Vers}}
- Modèle {{Exergue}}