Aide:Note (aide détaillée)

Aide de Wikipédia Insérer une image, une référence, etc.

Cette page ne concerne que le wikicode (liens « modifier le code »).

Voir la page d'aide pour l'éditeur visuel.
Quelle différence ?

Niveau expert

Nous vous recommandons de lire auparavant la page d'aide de base concernant les Notes

Les notes de bas de page permettent de lier un fait présenté dans le texte à une source. Le lecteur peut ainsi vérifier rapidement l'information. Elles permettent aussi d’insérer des commentaires du rédacteur d’un article, voire de citer ceux d’un rédacteur d’une source, tout ceci sans surcharger le texte, car de la sorte elles se retrouvent reportées en bas de page.

Il est possible de signaler deux fois la même digression ou la même source à plusieurs endroits du texte.

Dans ce cas, la note doit afficher un numéro unique, bien qu'il y ait plusieurs appels. Le texte de la note ne sera rédigé qu'une seule fois (techniquement le premier ajout de code dans l'article, indépendamment de sa place, et non le premier appel que l'on trouve dans l'article) et un nom (il doit commencer par une lettre) (paramètre name="…") lui sera associé.

Remarque

L'utilisation de guillemets droits (prévus par défaut dans les outils de la fenêtre de modification), encadrant le nom de la note, est souhaitable car cela permet de s'affranchir de problèmes pouvant apparaître lors de l'utilisation d'espaces et/ou de caractères spéciaux ou accentués.

Ensuite, pour réutiliser la même note, il suffit de la dupliquer entièrement, mais aussi de faire un appel à la balise <ref paramétrée avec le même name="…" et munie d'une barre oblique /> (plus besoin alors de dupliquer tout le texte de la note).

Exemple : voir les notes de l'article « Raton laveur ».

Attention : lors de la suppression ou du déplacement de passages, s'il y a une <ref name="manote">texte de la note</ref>, ne pas la faire disparaître totalement mais l'écrire à la place de la deuxième référence conservée dans le texte (<ref name="manote" />), faute de quoi il apparaît ce message d'erreur : « Erreur de citation : Balise <ref> incorrecte ; aucun texte n’a été fourni pour les références nommées (nom de la référence) » dans la liste des notes et références.

Lorsque plusieurs notes sont cumulées à un même endroit du texte, on peut intercaler le modèle {{,}} entre elles pour mieux les distinguer.

Sans cela, on pourrait croire à une seule note n^o 12, comme ceci :

Texte^[1][2]. Suite du texte…

Dans les deux cas, on retrouve les notes en bas de page :

Remarque

Dans l'explication qui précède on voit qu'il n'y a aucun identificateur donné avec name= (et que s'il n'y a pas la structure des notes avec un groupe), la duplication simple fournit sur la même ligne de bas de page la note.

Le modèle {{Références}} (équivalent de la balise <references />), sans paramètres, définit des colonnes par défaut de 30 em ou cadratins^[a].
(Le modèle {{Notes}} est une redirection douce sur {{Références}} et agit pareillement pour le paramétrage des colonnes).

{{Références}} 

Facultativement, pour mettre la liste sur plusieurs colonnes d'une taille donnée, il est possible d'utiliser le modèle {{Références}} avec un paramètre. Les explications sur ce paramètre sont données ici : « Modèle:Références – Affichage sur plusieurs colonnes ». Exemple :

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

Le modèle {{Références}} admet aussi un paramètre « groupe » pour les références groupées (bien noter que, dans ce cas, « groupe » s'écrit en français, donc avec un « e » final) :

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

Note

Ces syntaxes complexes sont utilisées pour les articles les plus élaborés et ceux qui prétendent à un label afin de mettre en forme de façon plus fine l'abondance des sources et commentaires.

Notes groupées[modifier | modifier le code]

Wikipédia utilise un code qui ne permet pas directement de faire la distinction entre

- d'une part, les notes de références — ou notes médiagraphiques — qui rappellent le cheminement documentaire et les auteurs consultés pour renforcer l'argumentation ;

- et d'autre part, les notes de commentaire — ou notes de contenu — qui servent à détailler un point moins important en permettant d'apporter un éclairage supplémentaire.

Mais cette distinction peut être introduite, lorsque l'article devient plus élaboré, en utilisant les notes groupées. Voir un exemple d'utilisation sur la page des recommandations typographiques.

Il est ainsi possible de grouper des notes en leur donnant un nom de groupe. Néanmoins, le nom de groupe ne peut être quelconque car c’est ce nom qui apparaît dans le texte en exposant en tant que préfixe de l’appel de note. Cette méthode de regroupement des notes s'avère très utile pour séparer les commentaires et les sources (exemple : « group=note » pour les notes de commentaires, « group=S » pour les notes de références, ) ou bien pour renvoyer aux différentes pages d'un même ouvrage de référence (exemple : « group=M » pour les références dans les pages du chapitre Martin, « group=Dt » pour les références dans le chapitre Dupont, « group=Ds » pour les pages dans le chapitre Dubois, etc.) comme cela a été fait dans l'article Paris.

Code à utiliser au fil du texte (bien veiller à ne pas mettre de « e » à la fin du mot « group » à l'intérieur de la première balise <ref>, car le mot s'écrit ici en anglais, — mais pour les modèles que l'on peut utiliser pour les fonctions identiques, voir plus loin, la francisation oblige à utiliser « groupe » —)

<ref group="A">Texte en note de bas de page.</ref>

ou bien :

<ref group=A>Texte en note de bas de page.</ref>

Code à mettre dans la section appropriée, en dessous de l'article (les 3 possibilités indiquées fonctionnent indifféremment ; les deux dernières permettent en plus l'affichage en plusieurs colonnes, en utilisant le paramètre « colonnes = »)

Notes : <references group="note" /> ou  {{Notes}} (qui est conçu pour afficher les renvois du groupe « note ») Source A : <references group="A" /> Source B : <references group="B" /> 

ou bien (dans ce cas, « groupe » s'écrit en français, donc avec un « e ») :

Source A : {{Références|groupe="A"}} Source B : {{Références|groupe="B"}} 

ou encore (dans ce cas aussi, « groupe » s'écrit en français, donc avec un « e ») :

Source A : {{Références|groupe=A}} Source B : {{Références|groupe=B}} 

Voir également : « Affichage en plusieurs colonnes ».

Exemple

(Nota : ci-dessous, le texte latin est en italique et les notes de commentaire ne le sont pas.)

Lorem ipsum dolor sit amet, consectetuer adipiscing elit^{[note 1]}. Sed non risus. Maecenas ligula massa, varius a, euismod non, mi. Proin porttitor, nonummy molestie, nisl eleifend mi, non fermentum diam nisl sit amet erat^{[A 1]}. Suspendisse enim diam tortor, dignissim amet, adipiscing nec, dolor. Proin, nonummy molestie^{[B 1]}, eleifend mi fermentum, consectetuer adipiscing elit. Sed non risus^{[A 2]}. Maecenas ligula massa^{[note 2]}, varius a^{[B 2]}, euismod non, mi^{[B 3]}.

Rendu

Notes :

Source A :

Source B :

Notes groupées à appels multiples[modifier | modifier le code]

Pour obtenir des notes à appels multiples à une même note groupée (par exemple, si une page de livre contient un peu plus d'information référencée en plusieurs endroits d'un article), il est possible de combiner group= et name= de cette façon : <ref group="<étiquette1>" name="<argument-index>">.
En particulier, il n'est pas nécessaire de déclarer le contenu de la note dès son premier appel dans la page.
Ceci fonctionne comme un appel simple sans groupe.
Comme mentionné au début de cet article (cf. remarque du § #Notes à appels multiples), l'usage de guillemets droits est facultatif avec le paramètre group= car on utilise peu de lettres (habituellement une ou deux, cinq au maximum) pour désigner le groupe, lettres de surcroît non accentuées.

Exemple de structure

<ref group="GM" name="p123" /> <ref group="GM" name="p123">{{nobr|page 123}}.</ref> <ref group="GM" name="p123" /> 

Exemple complet première mouture

Appel de la première note sans nom<ref group="GM">{{p.}}10.</ref>. Rappel de la deuxième note avec son nom<ref group="GM" name="p20" />. Appel de la troisième note sans nom<ref group="GM">{{p.}}30.</ref>. Appel dupliqué de la troisième note sans nom<ref group="GM">{{p.}}30.</ref>. Appel de la deuxième note création du nom<ref group="GM" name="p20">{{p.}}20.</ref>. Source GM : {{Références|groupe="GM"}} 

Exemple complet deuxième mouture

(mais, sans utiliser les guillemets derrière le paramètre group= ; en revanche l'utilisation des guillemets derrière le paramètre name= reste conseillée)

Appel de la première note sans nom<ref group=GM>{{p.}}10.</ref>. Rappel de la deuxième note avec le nom <ref group=GM name="p20" />. Appel de la troisième note sans nom<ref group=GM>{{p.}}30.</ref>. Appel dupliqué de la troisième note sans nom<ref group=GM>{{p.}}30.</ref>. Rappel de la deuxième note création du nom<ref group=GM name="p20">{{p.}}20.</ref>. Source GM : {{Références|groupe=GM}} 

Rendu

Appel de la première note sans nom^{[GM 1]}. Rappel de la deuxième note avec le nom ^{[GM 2]}. Appel de la troisième note sans nom^{[GM 3]}. Appel dupliqué de la troisième note sans nom^{[GM 4]}. Rappel de la deuxième note création du nom^{[GM 2]}.

Source GM :

Remarque

Les identificateurs donnés en name= doivent être différents à l'intérieur d'un même groupe (y compris du groupe sans nom), mais peuvent être identiques d'un groupe à l'autre sans entraîner de conflit.

Par exemple, ceci donne trois notes distinctes :

* <ref group="A" name="p1">

* <ref group="B" name="p1">

* <ref name="p1">

Notes imbriquées[modifier | modifier le code]

Il s'agit de notes dans une note. Cela n'est pas possible avec la cascade des balises <ref>extérieure<ref name="I">intérieure</ref>fin-extérieure</ref>, — elles produisent le message suivant :
Erreur de référence : Balise fermante </ref> manquante pour la balise <ref>fin-extérieure</ref>.

À la place, il faut employer le modèle {{Note}}, au moins pour la note la plus externe. Les notes imbriquées devraient être employées avec parcimonie car elles peuvent rendre la consultation fastidieuse. Une utilisation typique est le renvoi entre des groupes de références distincts, par exemple lorsqu'on fournit une source pour une note :

{{note|groupe=alpha|texte=On notera que ce E ne se prononce pas dans le dialecte du Nord de la Syldavie<ref>Phonétique syldave, T. Tournesol.</ref> bien qu'il soit toujours présent à l'écrit.}}^[a] ;

Autres exemples courants :

1. {{note|groupe=alpha|texte=Blabla Blabla…Texte de la note… Blabla Blabla<ref>{{harvsp|NomAuteur|AnnéeÉdition|p=numéro de page}}.</ref> Blabla Blabla.}}^[b] :
   • cas où l'ouvrage de l'auteur « NomAuteur », publié en « AnnéeÉdition », 1983 p. ex., se trouve dans une section « Bibliographie » de l'article et y est défini au moyen du modèle {{Ouvrage}}, cf. aussi la documentation du modèle {{harvsp}} ;
2. {{note|groupe=alpha|texte=Blabla Blabla…Texte de la note… Blabla Blabla{{sfn|NomAuteur|AnnéeÉdition|p=numéro de page}} Blabla Blabla.}}^[c] :
   • cas où l'ouvrage dû à l'auteur « NomAuteur » et publié en « AnnéeÉdition », 1983 p. ex., se trouve dans une section « Bibliographie » de l'article et y est défini au moyen du modèle {{Ouvrage}}, cf. aussi la documentation du modèle {{sfn}}, modèle dont l’utilisation est un peu plus concise que celle du modèle {{harvsp}} cité dans la ligne d’exemple au-dessus.

Notes (section « Notes imbriquées »)[modifier | modifier le code]

Notes du traducteur (section « Notes imbriquées »)[modifier | modifier le code]

Références (section « Notes imbriquées »)[modifier | modifier le code]

Bibliographie sommaire (section « Notes imbriquées »)[modifier | modifier le code]

• Prénom NomAuteur, Titre de l'ouvrage, LieuÉdition, annéeÉdition.

Définir la note directement dans la section « Notes et références »[modifier | modifier le code]

Depuis septembre 2009 (comme annoncé dans ce message), il est possible de définir, selon les besoins, certaines notes dans la partie références, évitant ainsi d'avoir le code entier dans le texte lui-même.

Cependant pour la note insérée, qui comporte l'identifiant name="nom", celle qui est définie dans le corps d'article avec le même identifiant name="nom" peut rester son duplicata exact (texte de note compris) — et non l'appel raccourci préconisé <ref name="nom"/> — : il n'y aura pas doublon.

Le « conteneur » (première méthode) — ou (deuxième méthode) le modèle {{Références|références=''<ref name="nom">texte-d'une-note</ref>''}} — chargé de notes récupère aussi les notes non chargées selon la portée (voir section suivante).

Le principe général est :

Avec les balises <references> </references> (méthode brute Mediawiki)

1. Dans la section des références, développer le <references /> en un conteneur
   (saisir <references> </references>) ;
2. Dans ce conteneur, définir la référence nommée et son corps
   (saisir <ref name="nom">Texte.</ref>) ;
3. Dans l'article, utiliser des « rappels » de note à son nom
   (saisir <ref name="nom" />).

Ou avec le modèle {{Références}} (méthode spécifique à fr.wikipedia.org peut introduire des biais à l'exportation d'article)

1. Introduire le paramètre références=
2. Dans ce paramètre définir la référence nommée et son corps
   (saisir <ref name="nom">Texte.</ref>) ;
3. Dans l'article, utiliser des « rappels » de note à son nom
   (saisir <ref name="nom" />).

Un exemple

ou

Cette manière de faire fonctionne avec les groupes de notes ainsi qu'avec les appels multiples de la même note.
Remarque

le numéro-index 1 n'est pas défini par la séquence d'écriture sous la section des références mais par l'ordre des appels de note dans le corps de l'article.

Exemple complet

En japonais, le terme ''[[senpai]]'' (prononcé<ref name="pron" /> « sème-paille<ref group="NB" name="pron" /> ») désigne un aîné, en particulier<ref group="NB">(Ceci est un appel de note groupé défini dans le corps du texte.)</ref> entre élèves ou étudiants<ref>(Ceci est un appel de référence classique dans le corps du texte.)</ref>. ;Notes <references group="note"/> == Notes == <references group="NB"> <ref name="pron">Les normes actuelles de [[Romanisation (écriture)|romanisation]] ont imposé la graphie ''senpai'', mais devant un B ou un P, le N consonant se prononce comme un M consonant (ceci est une note donnant un commentaire sur la prononciation ; la note est définie en bas dans Notes groupement NB et peut être réutilisée une ou plusieurs fois dans le corps de l'article avec la syntaxe habituelle d'un « rappel »).</ref> </references>  == Références == <references> <ref name="pron">Dupont 1999, {{p.}}123. (Ceci est une référence citant une source pour la prononciation. La référence est définie en bas dans Références et peut être réutilisée une ou plusieurs fois dans le corps de l'article avec la syntaxe habituelle d'un « rappel ».)</ref> </references> 

Rendu de l'exemple complet

Remarques

Attention : s'il est possible avec {{Colonnes}} (paramétré |taille=x|nombre=y) et avec {{Bloc solidaire}} de configurer la méthode du « conteneur » avec votre cascade de feuilles de style CSS, ce n'est pas forcément celle des autres, le système du « modèle Références » a pour but déclaré en février 2023 d'être consensuel.

• Les noms des références doivent être distincts à l'intérieur d'un même groupe, mais peuvent être homonymes d'un groupe à l'autre sans problème (dans l'exemple ci-avant, la référence « pron » du groupe « NB » est indépendante de la référence homonyme du groupe de base sans nom).
• À l'intérieur d'un bloc <references group=>, les notes définies sur place n'ont plus besoin d'utiliser le paramètre « group= » déjà donné pour le bloc, bien que cela fonctionne aussi (dans l'exemple ci-dessus, la définition dans le groupe « NB » avec <ref name="pron"> marche aussi bien qu'avec <ref group="NB" name="pron">.)
• Il n'est pas possible de créer un appel de référence à l'intérieur du texte d'une note du bloc avec <ref>. Pour sourcer le commentaire sur la prononciation dans l'exemple ci-dessus, on peut :
  • Indiquer le texte de la référence à la fin du texte du commentaire (entre parenthèses ou après une indication « Source : ») ;
  • Cumuler un appel de note et un appel de référence séparés (voir la section Plusieurs notes à un même endroit du texte ci-avant) ;
  • Insérer une référence à l'intérieur d'une note ne se fait pas sous le bloc <references group=>, elles sont définies en deux segments séparés qui ne se reportent pas de l'un à l'autre.
    • Cependant dans l'article cela fonctionne avec {{Note}} de la manière suivante :
      « {{note|bla bla bla<ref name="sousnote" />|groupe=note}} » ou « {{note|bla bla bla{{note|nom=sousnote}}|groupe=note}} » -on peut utiliser {{Ref}} tout pareil-; c'est fait en lieu et place de « <ref group="note">bla bla bla<ref name="sousnote" /></ref> » qui ne fonctionne pas.

Les notes imbriquées ne sont pas en 2012 approuvées de manière consensuelle (voir Wikipédia:Sondage/Utilisation d'une syntaxe de fonction parseur dans les articles pour créer des notes dans des notes) et devraient être utilisées avec circonspection.

• Le texte des notes du bloc <references group=> n'est plus attaché au corps de l'article. Il faut donc être attentif à en copier également le contenu relatif à chaque note lors d'exports vers d'autres pages (par exemple en cas de fusion).

La portée des renvois[modifier | modifier le code]

Les renvois <ref></ref> {{Sfn}}, {{Note}}, {{Efn}}, {{Ref}} sont dit « en bas de page ». Il s'agit par ce moyen de faire des apartés et de signaler les références utilisées. À mettre en place selon la situation :

• cela peut être en fin de section ou de sous-section de l'article pour un détail d'explication qui ne concerne pas le reste de l'article (comme supra l'exemple concernant la prononciation japonaise) ;
• cela peut être au pied d'un tableau ou d'une grille dont on veut garder les cellules dans une taille raisonnable (comme pour l'article Liste des paquets GNU) ou encore pour garder une présentation homogène d'une liste-à-puces (qui peut être mise dans une grille) (voir Historique des versions d'Android) ;
• cela peut être d'une portée générale dans l'article traité.

Il est possible donc d'utiliser des « appels de référence classique » (sans groupe) pour le détail d'explication à portée réduite ;
- Le code {{Références}} est mis en fin de section avec un sous-titre hors sommaire (style '''Remarques''') ;
Il est possible aussi d'utiliser un groupe pour sélectionner des cellules dans une colonne dans un tableau-grille ;
- Le code {{Références}} avec ou sans groupe est mis au pied du tableau-grille, le nom de groupe peut être réutilisé ensuite s'il le faut pour un prochain segment d'article
On peut mettre des groupes qui ont une portée pour tout l'article dans la section == Notes et références ==
- Le code {{Références}} est décrit ci-dessus.

Remarque

Chaque {{Références}} prend en compte et affiche ce qui est défini au dessus de lui, ce peut être juste une affaire de colonnes de son affichage.

Normalement, les notes s'affichent en bas de l'article, à l'emplacement des modèles {{Références}} et {{Notes}} qui est une redirection sur le premier — ou de la balise <references /> —.

Mais il existe un gadget très utile, tooltipRef, qui « permet de consulter les notes et références dans une fenêtre contextuelle qui s'affiche immédiatement sans avoir à se déplacer en bas de page » : voir à l'onglet « Préférences », le sous-onglet « Gadgets ». La consultation des notes en est ainsi rendue beaucoup plus rapide, et par conséquent nettement plus agréable.

Le gadget ReferenceDeroulante, quant à lui, permet de disposer les références dans une boîte défilante sans effet de mise en colonne.

Comme l'usage de ces gadgets se choisit dans l'onglet « Préférences » propre à un utilisateur, cette possibilité nécessite par définition de disposer d’un compte utilisateur Wikipédia et d’être connecté. Elle n'est donc pas accessible aux utilisateurs qui contribuent sous IP.