Modèle:Références/Documentation

De Wikivoyage
Ceci est la page de documentation du modèle {{Références}}.
Cette sous-page contient les instructions, les catégories et les liens interlangues de son modèle d’origine et elle n’est pas destinée à être visualisée directement.

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. Pour les autres navigateurs, l’affichage se fera automatiquement sur une seule colonne.

Utilisation[modifier]

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

(On peut remplacer « groupe=… » par « group=… ».)

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

(On peut remplacer « références=… » par « refs=… ».)

Exemples[modifier]

  • Exemple[1] sur deux[A 2] colonnes[2] (sous Konqueror, Opera et Internet Explorer[3], le résultat reste[A 3] sur une colonne) :
  1. bla bla
  2. 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, voire de xyloglossie ; et encore, c’est un euphémisme), sinon à créer un texte, qui, outre le fait qu’il est extrêmement alambiqué, soit long et ennuyeux — pour ne pas dire : désagréable — à lire. En ce sens, il a quelque ressemblance avec w:Wikipédia:Le Bistro.
  3. Ce navigateur web n’existe que pour Windows et, en développement arrêté, pour d'autres systèmes tel Mac OS.

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

  1. Une référence dans le groupe « A »
  2. Voir l’article Deux
  3. du verbe « rester »
  • Exemples de références[1] déclarées dans le modèle[2] :
  1. Exemple 1
  2. Exemple 2

En cas d'utilisations multiples du modèle[modifier]

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

Voir aussi[modifier]