Voir la source de Modèle:Références/Documentation

{{Sous-page de documentation}}<includeonly>{{Protection}}</includeonly>

== Présentation ==
Ce modèle ajoute les '''[[Aide:Note|notes et références]]''' en bas de page.

Il est possible d’afficher les notes sur plusieurs colonnes. Ce procédé ne fonctionne pas sur les anciens navigateurs (notamment avec {{nobr|Internet explorer 9}} et antérieurs) ni, de manière délibérée, avec le paramètre <code>colonnes</code> ou le paramètre <code>taille</code> lorsque le gadget ''ReferenceDeroulante'' est activé dans vos préférences.

Il permet également d’organiser des regroupements de notes ou références dans la section dédiée de bas de page.

== Syntaxe ==
=== Valeur par défaut ===
Sans paramètres (équivalent de la balise <nowiki><references /></nowiki>) :
<pre>{{Références}}</pre>

La largeur des colonnes <u>définie par défaut dans [[MediaWiki]]</u> est de {{unité|30 {{Lien|langue=en|trad=Em (typography)|fr=Em (typographie)|texte=''em''}}}} ou [[cadratin]]s{{note|groupe=alpha|texte=Ces deux termes ({{Lien|langue=en|trad=Em (typography)|fr=Em (typographie)|texte=''em''}} et [[cadratin]]) sont des synonymes.}} s'il y a plus de {{nombre|10 références}} (et reste sur une colonne s'il y a {{nombre|10 références}} ou moins). Cette mise en colonnes automatique permet que la présentation de la section dédiée s'adapte sans autre artifice à la plupart des écrans ceci étant pratiquement impossible autrement.

Les explications sur le paramètre taille sont données [[#En indiquant la taille minimale de chaque colonne|ci-dessous]].

=== Affichage sur une seule colonne ===
Pour obtenir cette mise en page, on peut choisir une valeur du paramètre <code>taille</code> suffisamment grande, par exemple « taille=60 ». Les explications sur le paramètre taille sont données [[#En indiquant la taille minimale de chaque colonne|ci-dessous]].

=== Affichage sur plusieurs colonnes ===
L'affichage sur plusieurs colonnes n'a aucun caractère obligatoire et ne doit être envisagé que pour réduire la hauteur de la section références, par exemple si celle-ci est très longue et contient des références courtes comme dans le cas de l'utilisation de modèles tels que {{m|sfn}}, {{m|harvsp}} et apparentés.

L'affichage sur plusieurs colonnes est configurable avec les paramètres <code>taille</code> ou <code>colonnes</code>. Avec ces paramètres, l'affichage se fait en colonnes même s'il y a moins de dix références.

==== En indiquant la taille minimale de chaque colonne ====
On peut faire varier la valeur du paramètre <code>taille</code>, qui donne la taille minimale de chaque colonne exprimée en {{Lien|langue=en|trad=em (typography)|fr=em (typographie)|texte=''em''}} ou [[cadratin]]s. Par exemple <code><nowiki>{{Références|taille=20}}</nowiki></code> permettra l'affichage sur trois colonnes pour les écrans pour lesquels <code><nowiki>{{Références|taille=30}}</nowiki></code> permet d'en afficher deux. Le nombre de colonnes effectivement visibles dépend de la taille de l’écran de l'utilisateur ; le navigateur Internet adapte son affichage à la taille de l’écran en question{{note|groupe=alpha|nom=déftaille|texte=La valeur du paramètre indiquée derrière « <code>taille=</code> » donne en {{Lien|langue=en|trad=Em (typography)|fr=Em (typographie)|texte=''em''}} ou [[cadratin]]s la largeur de colonne (des notes ou références) souhaitée ; ensuite le logiciel d’affichage du navigateur Internet divise la taille de l’écran par la largeur de colonne souhaitée pour déterminer le nombre de colonnes à afficher. Un moyen simple pour avoir une estimation de la largeur de colonne souhaitée utile ({{i.e.}} sans le numéro de note ni l'espace qui suit, autrement dit le seul texte de la note) est de remplacer les termes « ''em'' » ou « cadratin » par la lettre majuscule « W » (ou le groupe de chiffres « 00 ») dont la largeur d’affichage est censée être celle d’un cadratin. Un test effectué ci-dessous dans un exemple {{infra|cadratin}} montre que le groupe « 00 » est plus proche de la longueur du cadratin que la lettre « W » ; les tests ont en effet été présentés jusqu'à la limite qui n'impose pas un élargissement de l’écran, {{i.e.}} qui n'impose pas de déclencher un ''scrolling'' horizontal. Ces observations tendent à prouver la validité des observations de [[Jean-Pierre Lacroux|Lacroux]] qui ont été reprises dans l’article « [[cadratin]] ».}}.

{{ancre|Note_taille}}Note : il n'est pas possible de satisfaire pleinement tous les lecteurs avec le paramètre taille. Une valeur de {{unité|72 ''em''}} pour la largeur maximale semble permettre de ne pas trop pénaliser les configurations extrêmes (petits et grands écrans). On peut à partir de cette valeur utiliser les sous-multiples : '''72, 36, 24, 18, 14, 12, 10'''. La valeur par défaut étant « taille=30 », on peut aussi se baser sur la séquence '''60, 30, 20, 15, 10, 6'''.  Il est inutile de vouloir régler ces valeurs afin de les faire correspondre à sa propre configuration, qui n'est qu'un cas particulier parmi toutes celles possibles.

==== En indiquant la taille minimale de chaque colonne et le nombre maximal de colonnes ====
En cas d'utilisation des paramètres <code>taille</code> et <code>colonnes</code> simultanément, le paramètre <code>colonnes</code> permet de définir le nombre maximal de colonnes.

==== En indiquant le nombre de colonnes ====
Syntaxe obsolète. En cas d'utilisation du paramètre <code>colonnes</code> seul, celui-ci est remplacé automatiquement par le paramètre <code>taille</code> selon la règle suivante :
* 1 → 72 ;
* 2 → 36 ;
* 3 → 24 ;
* 4 → 18 ;
* 5 → 14.4 ;
* 6 → 12 ;
* 7 → 10.3 ;
* 8 → 9 ;
* toute autre valeur est ignorée.
Le paramètre <code>colonnes</code> est approximatif, puisque le nombre de colonnes obtenu dépend à la fois du paramètre et de la taille de l'écran.

=== Regroupement de références ===
Pour des références groupées :
 {{((}}Références|taille=xx|groupe=''nom de groupe''}}

==== En utilisant les lettres de l'alphabet latin ou celles de l'alphabet grec ====
Pour des numéros de notes alphabétiques (a, b, c…) on peut utiliser le groupe prédéfini « alpha » (les appels de notes doivent aussi utiliser le groupe « alpha »), par exemple :
<pre>{{Références|taille=36|groupe=alpha}}</pre>
ou pour des numéros de notes en minuscules grecques (α, β, γ…) le groupe prédéfini « grec », par exemple :
<pre>{{Références|taille=24|groupe=grec}}</pre>

==== En fournissant le nom souhaité du groupe ====
Pour déclarer les références directement dans le modèle :
 {{((}}Références|références= 
 &lt;ref name="''nom de la référence''">''texte de la référence''</ref>
 }}

== Exemples d'utilisation montrant divers modes d’affichage des notes ou références ==
=== Exemple sur une seule colonne ===
<pre>
{{Références}}
</pre>
Exemple<ref>Bla bla.</ref> de références<ref name=modele>http://fr.wikipedia.org/wiki/Modèle:Références ; exemple de référence nommée (à distinguer du groupe) ; ce qui lui permet d’être appelée plusieurs fois en rappelant son nom.</ref> sur une<ref>Testing.</ref> colonne<ref>http://fr.wikipedia.org/wiki/Accueil.</ref>{{,}}<ref>{{ISBN|123456789X}}.</ref>{{,}}<ref name="modele"/>{{,}}<ref group=Q>Une référence dans le groupe « Q ». Les notes sont rangées en cet endroit : {{infra|groupeQ}}.</ref> ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grec{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|1}}.}} {{infra|grec}} puis un second{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|2}}.}} puis un troisième{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|3}}.}} :
{{Références}}

{{ancre|cadratin}}
=== Exemple avec des colonnes de taille 24 cadratins (ou ''em'') au maximum ===
<pre>
{{Références|taille=24}}
</pre>
Exemple<ref>Bla bla.</ref> sur plusieurs<ref group=Q>Voir l’article [[2 (nombre)]]. Une autre référence dans le groupe « Q ». Les notes sont rangées en cet endroit : {{infra|groupeQ}}.</ref> colonnes<ref>Cette note, ainsi que la suivante, ne sert à rien, mais alors absolument à rien, je dirais même plus : elle est l’exemple parfait de prose inutile{{etc}}</ref> (sous [[Konqueror]]<ref name="lorem">{{Lorem ipsum|2}}. Autre exemple de référence nommée (à distinguer du groupe) ; ce qui lui permet d’être appelée plusieurs fois en rappelant son nom.</ref> et [[Internet Explorer]]<ref>Ça marche depuis la version 10. Ce [[navigateur web]] n’existe que pour [[Microsoft Windows]] et, en développement arrêté, pour d'autres systèmes tel [[Mac OS]].</ref>, le résultat<ref name="lorem"/> reste<ref group=Q>Du verbe « rester ». Une autre référence dans le groupe « Q ». Les notes sont rangées en cet endroit : {{infra|groupeQ}}.</ref> sur une colonne<ref group=alpha>Groupe « alpha ». Une référence dans le groupe « alpha », où les notes sont classées selon les lettres de l'alphabet, ce qui permet des appels de note plus discret dans le corps du texte. Les notes sont rangées en cet endroit : {{infra|latin}}.</ref>) ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grec{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|4}}.}} {{infra|grec}} puis un second{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|5}}.}} puis un troisième{{note|groupe=grec|texte=Exemple avec appel de note par une lettre grecque {{n°|6}}.}} ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen de la lettre « W »{{,}}{{note|texte=Avec 28 lettres « W »<br />WWWWWWWWWWWWWWWWWWWWWWWWWWWW}}{{,}}{{note|texte=Avec 29 lettres « W »<br />WWWWWWWWWWWWWWWWWWWWWWWWWWWWW}} ;  ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen des groupes « 00 »{{note|texte=Avec 24 fois « 00 »<br />000000000000000000000000000000000000000000000000}}{{,}}{{note|texte=Avec 25 fois « 00 »<br />00000000000000000000000000000000000000000000000000}} :
{{Références|taille=24}}

{{ancre|groupeQ}}
=== Exemple avec références groupées (nom de groupe « Q »)  ===
<pre>
{{Références|groupe=Q}}
</pre>
Les références (définies dans les exemples ci-dessus) pour le groupe « Q »<ref group=alpha>À ne pas confondre avec le groupe « alpha ». Les notes de ce groupe (« alpha ») sont rangées en cet endroit : {{infra|latin}}.</ref> apparaissent ci-après.
{{Références|groupe=Q}}

{{ancre|latin}}
=== Exemple avec références groupées selon les lettres de l'alphabet latin  ===
<pre>
{{Références|groupe=alpha}}
</pre>
Les références (définies dans les exemples ci-dessus) pour le groupe « alpha » apparaissent ci-après.

'''{{N.B.}} :''' elles ont également été utilisées pour la documentation de cette page, autrement dit « pas uniquement pour les exemples ci-dessus ».
{{Références|groupe=alpha}}

{{ancre|grec}}

=== Exemple avec références groupées selon les lettres de l'alphabet grec  ===
<pre>
{{Références|groupe=grec}}
</pre>
Les références (définies dans les exemples ci-dessus) pour le groupe « grec » apparaissent ci-après.
{{Références|groupe=grec}}

=== Exemple avec références définies en bas de page (l'appel se fait dans le corps du texte) - peu pratique pour la maintenance d’un article  ===
==== Exemple standard ====
<pre>
Texte (du corps d’un article) faisant appel à des références<ref name="modele1"/> déclarées dans le modèle<ref name="modele2"/>, c’est-à-dire en bas de page :
===== Références exemple A =====
{{Références|références=
<ref name="modele1">Exemple 1.</ref>
<ref name="modele2">Exemple 2.</ref>
}}
</pre>
Texte (du corps d’un article) faisant appel à des références<ref name="modele1"/> déclarées dans le modèle<ref name="modele2"/>, c’est-à-dire en bas de page :
===== Références exemple A =====
{{Références|références=
<ref name="modele1">Exemple 1.</ref>
<ref name="modele2">Exemple 2.</ref>
}}

==== Exemple de codage sans guillemet ====
On peut aussi écrire cet exemple sans les guillemets dans la mesure où le nom des notes tient en un seul mot (sans espace intercalaire) ; dans ce cas, dans l'appel de note, il convient de veiller à placer une espace entre le nom de la note (exemple : « modèle11 ») et la barre oblique (« / »)  :
<pre>
Texte (du corps d’un article) faisant appel à des références<ref name=modele11 /> déclarées dans le modèle<ref name=modele21 />, c’est-à-dire en bas de page :
===== Références exemple B (sans guillemets) =====
{{Références|références=
<ref name=modele11>Exemple 11.</ref>
<ref name=modele21>Exemple 21.</ref>
}}
</pre>
Texte (du corps d’un article) faisant appel à des références<ref name=modele11 /> déclarées dans le modèle<ref name=modele21 />, c’est-à-dire en bas de page :
===== Références exemple B (sans guillemets) =====
{{Références|références=
<ref name=modele11>Exemple 11.</ref>
<ref name=modele21>Exemple 21.</ref>
}}

== Paramètres ==
<templatedata>
{
	"description": "Modèle ajoutant les notes et références en bas de page.",
	"params": {
		"groupe": {
			"label": "Groupe",
			"description": "Nom de groupe de références",
			"type": "string",
			"suggested": true
		},
		"références": {
			"label": "Références",
			"description": "Pour déclarer les références directement dans le modèle",
			"type": "string"
		},
		"taille": {
			"label": "Taille",
			"example": "30",
			"type": "number",
			"description": "Largeur de colonne (en « em ») (*)",
			"suggested": true,
			"default": "30"
		},
		"colonnes": {
			"label": "Colonnes",
			"description": "Nombre de colonnes ; ou nombre maximal de colonnes quand la largeur de colonne est fixée",
			"type": "number",
			"deprecated": true
		},
		"pasdecol": {
			"label": "Pas de colonnes",
			"description": "Si largeur ou nombre de colonnes ne sont pas précisés, « pasdecol=oui » met sur une seule colonne en enlevant les colonnes par défaut de largeur 30 em (en fait n'importe quelle valeur, même « non », fait la même chose)",
			"example": "oui",
			"type": "string"
		}
	},
	"paramOrder": [
		"taille",
		"colonnes",
		"pasdecol",
		"groupe",
		"références"
	],
	"format": "inline"
}
</templatedata>

(*) Un {{Lien|langue=en|trad=Em (typography)|fr=Em (typographie)|texte=''em''}} est une abréviation utilisée en typographie par les anglophones pour le mot [[cadratin]].

== Voir aussi ==
* {{m|Références nombreuses}} pour afficher les références dans un cadre défilant
* [[Aide:Note]]
<includeonly>
{{DEFAULTSORT:References}}
[[Catégorie:Modèle de l'encyclopédie]]
</includeonly>