Aide:Note (aide détaillée)

Notes groupées

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 :

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

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

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

Notes imbriquées

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.

Définir la note directement dans la section « Notes et références »

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

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.