Voir la source de Citation bloc/Documentation

{{Sous-page de documentation}}

== Utilisation ==

Les modèles {{m|Citation bloc}}, {{m|Début citation}} et {{m|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 [[wp:Citation]].

== Incompatibilités ==
Un inconvénient de {{m|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 {{m|!}} et {{m|{{=}}}} qui permettent l'affichage de ces caractères sans poser de problèmes.

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

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

=== Signes ===
Exemples :
* Avec {{m|citation bloc}} :
 <code><nowiki>{{citation bloc|Les signes = et | sont dangereux.}}</nowiki></code>
{{citation bloc|Les signes = et | sont dangereux.}}
* Avec {{m|citation bloc}}, <nowiki>{{=}}</nowiki> et <nowiki>{{!}}</nowiki> :
 <code><nowiki>{{citation bloc|Les signes {{=}} et {{!}} sont dangereux.}}</nowiki></code>
{{citation bloc|Les signes {{=}} et {{!}} sont dangereux.}}
* Avec {{m|début citation}} :
 <code><nowiki>{{début citation}}Les signes = et | sont dangereux.{{fin citation}}</nowiki></code>
{{début citation}}Les signes = et | sont dangereux.{{fin citation}}

=== Listes à puces ===
Exemples :
* Avec {{m|citation bloc}} :
 <code><nowiki>{{citation bloc|Liste à puces :
* liste ;
* à ;
* puces.
Liste numérotées :
# Liste.
# Numérotée.}}</nowiki></code>
{{citation bloc|Liste à puces :
* liste ;
* à ;
* puces.
Liste numérotée :
# Liste.
# Numérotée.}}

== Syntaxe ==

<templatedata>
{
    "description": "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 ».",
    "params": {
        "1": {
            "label": "Citation",
            "type": "string",
            "required": true,
            "description": "Contenu de la citation : le texte mis entre guillemets."
        },
        "2": {
            "label": "Auteur",
            "type": "string",
            "description": "Nom de l’auteur de la citation"
        },
        "3": {
            "label": "Référence",
            "type": "string",
            "description": "Ouvrage de référence"
        },
        "style": {
            "type": "string",
            "description": "Si ce paramètre vaut « center », le texte est centré."
        }
    }
}
</templatedata>

 <code><nowiki>{{Citation bloc|citation|auteur|référence|style=center}}</nowiki></code>
* 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 ''(optionnel, vierge par défaut)''. 
* style=center : centrage du contenu de la citation ''(optionnel)''.

 <code><nowiki>{{Citation début}}citation{{Fin citation|auteur|référence}}</nowiki></code>
* 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 {{m|Citation bloc}}. Par exemple, le code :

<pre>{{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.}}</pre>

Donne comme résultat :

{{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.}}

En revanche, ce n'est le cas avec les modèles {{m|Début citation}} et {{m|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 {{m|Citation bloc}} ==

{{En-tête tableau "Code Rendu"}}
|-<!-- Le texte témoin permet de bien mettre en évidence le retrait que subira le texte cité, sans celui-ci la présentation sous forme de tableau rend la chose difficile à deviner -->
|<code>{{gris|Texte témoin.}}<nowiki>{{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.}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|-
|<code>{{gris|Texte témoin.}}<nowiki>{{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}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|-
|<code>{{gris|Texte témoin.}}<nowiki>{{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>.}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|-
|<code>
{{gris|Texte témoin.}}
<nowiki>{{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|</nowiki>'''style=center'''<nowiki>}}
{{citation bloc|{{la}} quod ab eundo nomen est ductum : dont le nom ''allant'' dérive.|Cicéron}}</nowiki>
{{gris|Texte témoin.}}
</code>
|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.
|}

== Exemples avec {{m|Début citation}} et {{m|Fin citation}} ==

{{En-tête tableau "Code Rendu"}}
|-<!-- Le texte témoin permet de bien mettre en évidence le retrait que subira le texte cité, sans celui-ci la présentation sous forme de tableau rend la chose difficile à deviner -->
|<code>{{gris|Texte témoin.}}<nowiki>{{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}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|-
|<code>{{gris|Texte témoin.}}<nowiki>{{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}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|-
|<code>{{gris|Texte témoin.}}<nowiki>{{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>.}}</nowiki>{{gris|Texte témoin.}}</code>
|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.
|}

{{références}}

== Voir aussi ==

;Pages de recommandations sur les citations :
* [[wp:Citez vos sources]]
* [[wp:Citation]]
* [[Aide:Note]]

;Autres modèles :
* Modèles {{m|Début citation}} et {{m|Fin citation}} : pour les citations longues dans un bloc indentable, équivalents à {{m|Citation bloc}}.
* Modèle {{m|Citation}} : pour les citations en français, intégrées dans le corps de texte
* Modèle {{m|Langue}} : pour les mots ou phrases en langue étrangère
* Modèle {{m|Citation bilingue bloc}} : pour mettre cote-à-cote une citation en langue étrangère et sa traduction en français
* Modèle {{m|Citation étrangère bloc}} : pour les citations en langue étrangère séparées du corps du texte.
* Modèle {{M|Aphorisme}}
* Modèle {{M|Vers}}
* Modèle {{M|Exergue}}

<includeonly>

[[Catégorie:Modèle citation|{{PAGENAME}}]]


</includeonly>