Modèle:Références/Documentation

Ce modèle ajoute les 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, de manière délibérée, avec le paramètre colonnes ou le paramètre taille 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.

Sans paramètres (équivalent de la balise <references />) :

{{Références}}

La largeur des colonnes définie par défaut dans MediaWiki est de 30 em ou cadratins^[a] s'il y a plus de 10 références (et reste sur une colonne s'il y a 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, cela étant pratiquement impossible autrement.

Les explications sur le paramètre taille sont données ci-dessous.

Pour obtenir cette mise en page, on peut choisir une valeur du paramètre taille suffisamment grande, par exemple « taille=60 ». Les explications sur le paramètre taille sont données ci-dessous.

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 {{sfn}}, {{harvsp}} et apparentés.

Cependant, les références étant affichées généralement dans un corps de texte réduit, elles produisent des blocs de texte difficiles à lire et suivre visuellement. Idéalement, pour l'accessibilité et le confort de lecture, les lignes de texte ne devraient pas excéder une largeur d'environ 36 em (environ 72 à 80 caractères) et devrait comporter des retours à ligne plus nombreux mais plus facile à repérer, provoquer moins de fatigue visuelle et mentale, et permettre une lecture plus rapide. L'utilisation du multicolonnage résout ce problème de la même façon que dans les articles de journaux et de nombreuses publications imprimées.

Si la largeur de page (ou de la fenêtre à l'écran) le permet et en tenant compte de la taille du corps de texte (la taille des polices utilisées), cela permet aussi de mieux utiliser cette largeur disponible afin d'éviter de larges bandes à gauche, et de réduire également la hauteur totale du bloc de références, en évitant de les faire défiler lors de la lecture, ce qui apporte également un confort visuel. Et cela n'empêche pas le lecteur de modifier le niveau de zoom ou ses tailles de police à l'affichage selon ses besoins : le nombre de colonnes s'adaptera automatiquement à la largeur totale disponible.

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

On peut faire varier la valeur du paramètre taille, qui donne la taille minimale de chaque colonne exprimée en em ou cadratins. Par exemple {{Références|taille=15}} permettra l'affichage sur trois colonnes pour les écrans pour lesquels {{Références|taille=20}} 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^[b].

Note : il n'est pas possible de satisfaire pleinement tous les lecteurs avec le paramètre taille. Une valeur de 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 cas d'utilisation des paramètres taille et colonnes simultanément, le paramètre colonnes permet de définir le nombre maximal de colonnes.

Syntaxe obsolète. En cas d'utilisation du paramètre colonnes seul, celui-ci est remplacé automatiquement par le paramètre taille 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 colonnes est approximatif, puisque le nombre de colonnes obtenu dépend à la fois du paramètre et de la taille de l'écran.

Pour des références groupées :

{{Références|taille=xx|groupe=nom de groupe}}

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 :

{{Références|taille=36|groupe=alpha}}

ou pour des numéros de notes en minuscules grecques (α, β, γ…) le groupe prédéfini « grec », par exemple :

{{Références|taille=24|groupe=grec}}

Appel qui ne fonctionne que pour les regroupées :

<ref name="nom de la référence" group="nom du groupe"/>

Pour déclarer les références qui ne fonctionnent que lorsqu'elles portent leur nom de groupe en tête du modèle et pas dans chaque déclaration :

{{Références|groupe=groupe souhaité|références= 
<ref name="nom de la référence">texte de la référence</ref>
}}

{{Références}}

Exemple^[1] de références^[2] sur une^[3] colonne^{[4],[5],[2],[Q 1]} ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grec^[α] (voir infra) puis un second^[β] puis un troisième^[γ] :

{{Références|taille=24}}

Exemple^[1] sur plusieurs^{[Q 2]} colonnes^[2] (sous Konqueror^[3] et Internet Explorer^[4], le résultat^[3] reste^{[Q 3]} sur une colonne^[c]) ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grec^[δ] (voir infra) puis un second^[ε] puis un troisième^[ζ] ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen de la lettre « W »^,[5],[6] ; ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen des groupes « 00 »^[7],[8] :

{{Références|groupe=Q}}

Les références (définies dans les exemples ci-dessus) pour le groupe « Q »^[d] apparaissent ci-après.

{{Références|groupe=alpha}}

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=grec}}

Les références (définies dans les exemples ci-dessus) pour le groupe « grec » apparaissent ci-après.

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

Texte (du corps d’un article) faisant appel à des références^[1] déclarées dans le modèle^[2], c’est-à-dire en bas de page :

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 (« / ») :

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

Texte (du corps d’un article) faisant appel à des références^[1] déclarées dans le modèle^[2], c’est-à-dire en bas de page :

Modèle ajoutant les notes et références en bas de page.

Paramètres du modèle

La mise en forme sur une seule ligne est préférée pour ce modèle.

Paramètre		Description	Type	État
Colonnes	colonnes	Nombre de colonnes ; ou nombre maximal de colonnes quand la largeur de colonne est fixée	Nombre	obsolète
Taille	taille	Largeur de colonne (en « em ») (*) Par défaut 25 Exemple 25	Nombre	facultatif
Pas de colonnes	pasdecol	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) Exemple oui	Chaîne	facultatif
Groupe	groupe group	Nom de groupe de références Valeurs suggérées note alpha grec romain	Chaîne	suggéré
Références	références refs	Les références doivent obligatoirement être de type <ref name="lenom"> le texte<ref>. Si utilisation d'un regroupement, le mettre seulement dans l'entête par le paramètre 'groupe'. ( appel dans l'article Editeur Visuel ou code appel <ref name="lenom" group="legroupe"/>) Exemple <ref name="lenom"> le texte <ref>	Chaîne	facultatif

(*) Un em est une abréviation utilisée en typographie par les anglophones pour le mot cadratin.

• {{Références nombreuses}} pour afficher les références dans un cadre défilant
• {{Références discussion}} pour afficher des références dans un format plus adapté aux pages de discussion
• Aide:Note