Modèle:Références/Documentation

De Vulgum Techus
Aller à : Navigation, rechercher

Présentation

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 sur les anciens navigateurs (notamment avec Modèle:nobr et antérieurs) ni, 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.

Syntaxe

Affichage sur une seule colonne

Sur une seule colonne (équivalent de la balise <references />) :

{{Références}}

Affichage sur plusieurs colonnes

L'affichage sur plusieurs colonnes n'a aucun caractère obligatoire, et ne doit être envisagé que pour faciliter la lecture des articles par réduction notable de la longueur d'affichage de la section références, par exemple si celle-ci est très longue et contient des références courtes, ou dans le cas des listes de références utilisant les modèles {{sfn}}, {{harvsp}} et apparentés.

En donnant une taille minimale à chaque colonne (facultatif)

Sur plusieurs colonnes en fonction de la dimension de l'écran, en donnant une valeur au paramètre « taille »Modèle:noteModèle:,Modèle:note (paramètre à préférer) qui donne la taille minimale de chaque colonne exprimée en Modèle:page h' ou cadratinsModèle:note : {{Références|taille=24}} (trois colonnes selon l'écranModèle:note) ou {{Références|taille=36}} (deux colonnes selon l'écranModèle:note).

Modèle:ancreNote : il n'est sans doute pas possible de satisfaire pleinement tous les lecteurs avec le paramètre taille. Une valeur de 72em pour la largeur maximum permet 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. Il semble 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 imposant le nombre de colonnes (obsolète)

Sur deux colonnes ou sur trois colonnesModèle:etc de manière imposée (l'usage de ce paramètre est déconseillé) : {{Références|colonnes=2}} ou {{Références|colonnes=3}}Modèle:etc

Pour faciliter la lecture sur les écrans de taille réduite, il est recommandé d'éviter tout effet de mise en page eu égard aux résultats contestables obtenus avec certains types d'écran ; ce paramètre est donc déclaré obsolète.

En conjuguant les deux paramètres précédents (« taille= » et « colonnes= »)

Il est possible de combiner l'usage de ces deux paramètres : dans ce cas, taille conserve le sens d’une taille minimale des colonnes (exprimée en em) tandis que colonnes définit ici un nombre maximal de colonnes (Modèle:N.B. : attention, le paramètre n'a alors plus le sens qu'il avait au § précédent, lorsqu'il était utilisé seul).

Cette méthode d’utilisation permet notamment de conserver un nombre de lignes suffisant à chaque colonne (on considère habituellement que, pour une présentation acceptable, chaque colonne doit disposer de trois lignes au minimum). Par exemple, dans le cas d’un écran large, si le nombre de références est Modèle:nobr, insérer le paramètre colonnes=5 combiné à un paramètre taille=xxModèle:note garantit que le nombre de colonnes ne pourra être supérieur Modèle:nobr, donc que chaque colonne disposera au moins de « 16 (références) divisé par 5 (colonnes) » lignes, soit trois lignes (en prenant la partie entière de « 16 divisé par 5 » qui vaut 3,2) par colonne.

Voir la note plus haut sur les valeurs à donner au paramètre taille.

Regroupement de références

Pour des références groupées :

Modèle:((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 :

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

En fournissant le nom souhaité du groupe

Pour déclarer les références directement dans le modèle :

Modèle:((Références|références= 
<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

{{Références}}

Exemple[1] de références[2] sur une[3] colonne[4]Modèle:,[5]Modèle:,[2]Modèle:,[Q 1] ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grecModèle:note Modèle:infra puis un secondModèle:note puis un troisièmeModèle:note :

Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

Modèle:ancre

Exemple avec des colonnes de taille 24 cadratins (ou em) au maximum

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

Exemple[6] sur plusieurs[Q 2] colonnes[7] (sous Konqueror[8] et Internet Explorer[9], le résultat[8] reste[Q 3] sur une colonne[alpha 1]) ; poursuite de l’exemple pour introduire un appel de note utilisant l'alphabet grecModèle:note Modèle:infra puis un secondModèle:note puis un troisièmeModèle:note ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen de la lettre « W »Modèle:,Modèle:noteModèle:,Modèle:note ;  ; poursuite de l'exemple pour prouver la largeur des colonnes au moyen des groupes « 00 »Modèle:noteModèle:,Modèle:note :

Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

Modèle:ancre

Exemple avec références groupées (nom de groupe « Q »)

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

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

Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

Modèle:ancre

Exemple avec références groupées selon les lettres de l'alphabet latin

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

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

Modèle:N.B. : elles ont également été utilisées pour la documentation de cette page, autrement dit « pas uniquement pour les exemples ci-dessus ».

Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

Modèle:ancre

Exemple avec références groupées selon les lettres de l'alphabet grec

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

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

Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

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

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[10] déclarées dans le modèle[11], c’est-à-dire en bas de page :

Références exemple A
Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

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

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[12] déclarées dans le modèle[13], c’est-à-dire en bas de page :

Références exemple B (sans guillemets)
Erreur de référence : Balise <references> incorrecte ;

seul l’attribut « group » est autorisé. Utilisez <references />, ou bien <references group="..." />.

Voir aussi

<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": "35" }, "colonnes": { "label": "Colonnes", "description": "Nombre de colonnes ; ou nombre maximum 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 35 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 Modèle:page h' est une abréviation utilisée en typographie par les anglophones pour le mot cadratin.



Erreur de référence : Des balises <ref> existent, mais aucune balise <references/> n’a été trouvée.
Erreur de référence : Des balises <ref> existent pour un groupe nommé « Q », mais aucune balise <references group="Q"/> correspondante n’a été trouvée, ou bien une valise fermante </ref> manque.
Erreur de référence : Des balises <ref> existent pour un groupe nommé « alpha », mais aucune balise <references group="alpha"/> correspondante n’a été trouvée, ou bien une valise fermante </ref> manque.