Modèle:Références/Documentation

Ceci est la page de documentation de Modèle:Références (modifier).
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Utilisation

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é fonctionnera sur la majorité des navigateurs dans les années à venir, mais est actuellement limité à certains navigateurs (dernière actualisation : juillet 2010) :

• les navigateurs utilisant le moteur de rendu Gecko, ce qui est le cas des navigateurs de la Mozilla Foundation (Firefox) ;
• les navigateurs utilisant le moteur WebKit (Safari depuis la version 3, Google Chrome, Chromium, etc.). Pour les autres navigateurs, l’affichage se fera automatiquement sur une seule colonne.

Syntaxe

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

{{Références}}

Sur deux colonnes :

{{Références|colonnes=2}}

Pour des références groupées :

{{Références|colonnes=2|groupe=''nom de groupe''}}

Pour déclarer les références directement dans 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

• Exemple de références sur une colonne :

• Exemple sur deux colonnes (sous Konqueror, Opera et Internet Explorer, le résultat reste sur une colonne) :

Les références pour le groupe « A » apparaissent ci-après.

• Exemples de références déclarées dans le modèle :

En cas d'utilisations multiples du modèle

Le logiciel MediaWiki met en cache les résultats des modèles, c'est-à-dire que pour un modèle utilisé plusieurs fois avec les mêmes paramètres (ou bien sûr sans paramètre), le résultat est en fait calculé lors de la première inclusion, et est ensuite réutilisé pour la suite de la page. En conséquence, il n'est pas possible d'utiliser ce modèle pour afficher plusieurs listes de références dont le nom est identique (ce qui inclut les listes sans nom).

Par exemple, ceci est incorrect et produit des erreurs :

lorem ipsum 1<ref>AAA</ref>
{{références}}

lorem ipsum 2<ref>BBB</ref>
{{références}}

Plusieurs solutions sont possibles, de la plus élégante à la moins élégante :

• La meilleure solution est d'organiser différemment la page afin de ne pas être confronté à un tel cas de figure. Les groupes nommés de références devraient normalement couvrir la quasi-totalité des besoins.
• Si la réorganisation n'est pas possible ou souhaitable, on peut utiliser <references />, qui n'est pas confronté au problème.
• On peut aussi « tromper » le logiciel MediaWiki, en ajoutant des faux paramètres, différents à chaque appel du modèle, afin de ne pas réutiliser les résultats mis en cache. Par exemple : {{Références|faux param 1=}}, {{Références|faux param 2=}}, etc.

Voir aussi

• Aide:Note

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

Paramètres du modèle

Paramètre		Description	Type	Statut
Colonnes	colonnes	Nombre de colonnes	Nombre	facultatif
Groupe	groupe	Nom de groupe de références	Chaîne	facultatif
Références	références	Pour déclarer les références directement dans le modèle	Chaîne	facultatif