Modèle:Ref

 Documentation[voir] [modifier] [historique] [purger]

Ce modèle remplace les balises de renvoi en bas de page:

- <ref>...</ref>
- <ref name="xxxx">...</ref>
et de rappel <ref name="xxxx"/>
- <ref group="yyyy">...</ref>
- <ref name="xxxx" group="yyyy">...</ref>
et de rappel <ref name="xxxx" group="yyyy"/>

Ce modèle fournit un renvoi en bas de page avec rappel automatique s'il est dupliqué.
Il est réduit au paramètre du texte en renvoi, au paramètre facultatif du lien de groupe qui est affiché pour son appel dans l'article, et au paramètre d'identification pour un rappel de la référence.
Un contrôle du paramétrage d'appel est effectué (il ne porte pas sur les appels à modèles qui sont mis dans les 3 paramètres positionnels non nommés).
N.B. Si des paramètres nommés sont utilisés dans votre appel, remplacez ce modèle Ref par le modèle {{Note}} ou {{Efn}} ou {{Sfn}} ou {{Lien web}} à écrire avec ses paramètres nommés et non nommés, ou bien pour le modèle Ref adaptez son paramétrage.
—Les articles comportant des références par ce modèle dont le paramétrage est défaillant sont catalogués dans les catégories additives [+]

La syntaxe d'appel de ce modèle Ref est normalisée lorsqu'on utilise l'éditeur visuel.
— Utilisez-le en recopiant dans l'article cible le code modèle ci-dessous et modifiez en cliquant sur l'index de renvoi affiché! —

SyntaxeModifier

{{Ref|<texte en renvoi de bas de page>|<groupe du renvoi>|<identifiant>}}
Exemples de syntaxe par wikicode
  • 1 simple {{Ref|<texte en renvoi>}}
    • (rappel automatique {{Ref|<texte en renvoi>}})
    • pour rappels par identifiant{{Ref|||<id>}}
      équivalent à {{Ref|3=<id>}}

Une mauvaise position des paramètres :

{{Ref|<identifiant pour rappel en position 1>|<texte en position 2>}}
- donne une erreur de groupe.
  • 2 groupement
    • (pas de groupe indiqué)
      • à l'endroit d'affichage : {{Références}}
    • {{Ref|<texte en renvoi>|<groupe du renvoi>}}
      • à l'endroit d'affichage : {{Références|groupe=<groupe du renvoi>}}
    • {{Ref|<texte en renvoi>|alpha}}
      • à l'endroit d'affichage : {{Références|groupe=alpha}}
    • {{Ref|<texte en renvoi>|grec}}
      • à l'endroit d'affichage : {{Références|groupe=grec}}

Une mauvaise position des paramètres:

{{Ref|<groupe du renvoi en position 1>|<texte en position 2>}}
- donne une erreur de groupe.

ExemplesModifier

-simple {{Ref|répète voir...}} [1]

-simple bis (répété automatiquement) {{Ref|répète voir...}} [1]

-avec nom (vouloir le séparer des 2 premiers obtenus par copié-collé) {{Ref|répète voir...||machin}} [2]

-et obtenir le rappel avec ce nom{{Ref|||machin}} [2]
-- ou bien rappel comme ça:{{Ref|3=machin}} [2]

-avec nom pour des rappels séparés sans groupe; en fait le nom constitue un sous-groupe qui n'apparait dans le texte de l'article que par le changement de numéro index {{Ref|répète voir...||truc}} [3]

-avec nom pour rappels séparés voulus (sans groupe) en duplicata {{Ref|répète voir...||truc}} [3]
-- ou encore comme ça sans groupe:{{Ref|||truc}} [3]
-- et encore comme ça:{{Ref|3=truc}} [3]

-avec groupe à index choisi{{Ref|répète voir...|L}} [L 1]

-avec groupe à même index choisi{{Ref|répète voir!|L}} [L 2]

-avec groupe, le bis copié-collé de l'appel du texte aux 3 points{{Ref|répète voir...|L}} [L 1]

-avec groupe et nom dans le groupe (cela constitue un sous-groupe du groupe, sous-groupe qui n'apparait pas dans le texte de l'article hormis le changement de numéro index) {{Ref|abcdef|L|nommé}} [L 3]

-rappel auto avec groupe et son sous-groupe par le nom {{Ref|abcdef|L|nommé}} [L 3]

-avec groupe à index en lettre romane minuscule{{Ref|répète voir...|alpha}} [a]

-avec groupe à index en lettre grecque minuscule{{Ref|répète voir...|grec}} [α]

-faire afficher en bas de page une référence de type "{{Harvard}} en 2 temps",
et 2 mouvements pour arriver à votre section de Bibliographie que vous créez ou qui est existante pouvant aller jusqu'à "La {{Bibliographie}}...": {{Ref|{{Harvsp|Hauteur|2018|loc=tome II, chapitre 3, p.168}}|référence|A}} [référence 1]
--qui est pointée par une note {{Efn|Wikipédia depuis ses débuts prend des formes diverses (interviews de tous les contributeurs {{Ref||référence|A}})}}[à-noter 1]
---cette note qui peut aussi s'écrire comme ça: {{Efn|Wikipédia depuis ses débuts prend des formes diverses (interviews de tous les contributeurs {{Ref|2=référence|3=A}})}}[à-noter 2]

Les appels imbriquésModifier

clef automatique

-Ref imbriquées (de texte simple):
{{Ref|texte1 {{Ref|texte2 {{Ref|texte3 {{Ref|texte4 |L}} |grec}} |alpha}} }} [[#cite_note-texte1_'-15|[4]]]

-en rappel, seule la dernière de la cascade, le plus profond niveau d'imbrication, peut être rappelée automatiquement:

clef manuelle

-Ref imbriquées d'appels en cascade pour des ouvrages:

{{Ref|ouvrage1c {{Ouvrage|auteur=auteurS|année=2018|titre=le livre S}} {{Ref|ouvrage2c {{Ouvrage|auteur=auteurA|année=2018|titre=le livre A}} {{Ref|ouvrage3c {{Ouvrage|auteur=auteurG|année=2018|titre=le livre G}} {{Ref|ouvrage4c {{Ouvrage|auteur=auteurL|année=2018|titre=le livre L}} |L|OL}} |grec|OG}} |alpha|OA}}||OS }}

[5]

-Ref imbriquées d'appel par exemple à des Harvsp en cascade:

{{Ref|cité par {{Harvsp|auteurS|2018|p=1}} {{Ref|en citation par {{Harvsp|auteurA|2018|p=2}} {{Ref|selon {{Harvsp|auteurG|2018|p=3}} {{Ref|repris par {{Harvsp|auteurL|2018|p=4}} |L|HC}} |grec|HB}} |alpha|HA}}||HD}}

[6]

-références en rappel d'une cascade, seuls les appels qui comportent des clés manuelles passent:

  • {{Ref|||HD}}[6]
  • {{Ref||L|HC}}[L 6]
  • {{Ref||grec|HB}}[δ]
  • {{Ref||alpha|HA}}[d]

Les sources reconnues pour faire référenceModifier

Les sources reconnues définitivement sur lesquelles on peut faire référence sans aucun problème sont dans des articles reconnus. Elles sont dans l'Espace référence qui les répertorie dans Référence:Index. Pour les utiliser avec le modèle Ref, si on veut les mettre dans un groupe, il est nécessaire de mettre une clef manuelle.

Exemple: {{Ref|{{JusHis}}|JH|jushist}}[JH 1]
référence affichée par: {{Références|groupe=JH}}
  1. Justin, Abrégé des Histoires philippiques de Trogue Pompée [détail des éditions] [lire en ligne]

Pour la source que l'on veut mettre en référence dans son article nouveau ou dans son ajout, il est avantageux d'aller la faire afficher par « Rechercher dans Wikipédia », et de consulter la liste rendue. Que le fonds soit écrit ou numérisé, il est bienvenu de mettre un lien dans le renvoi sur l'auteur de la référence s'il fait l'objet d'un article dans Wikipédia. Il est utile de consulter aussi:

  1. Wikipédia:Citez vos sources#Que faut-il étayer par des références ? (les principes fondateurs des citations et des références)
  2. Aide:Note (la mise en place nouvelle ou en addition dans un article, niveau pour tous)
  3. Aide:Présentez vos sources
  4. Aide:Présentez vos sources/avancée
  5. Aide:Utilisation avancée des références Harvard

Il vaut mieux comprendre pour des articles touffus ce qui sera considéré comme « source primaire » contestable, « source tertiaire » qui est mal venue s'il n'y a pas de source secondaire. Tout comme les incunables qui peuvent être sujets à caution, la polémique de spécialiste s'établit vite entre l'écorce et l'arbre de la connaissance en science plus ou moins exacte...qui peut aboutir à un rejet.
Et pour finir il n'est pas mauvais d'aller comprendre ce qui sera considéré comme "publicitaire" ou "promotionnel" ou encore autobiographique, ce qui pour ce dernier cas usuellement ne se discute même pas.

Pour ce qui concerne la localisation dans le code de l'article, il faut savoir que les {{Références}} peuvent être définies là où elles sont affichées, par groupe, et donc en dehors du texte de l'article, car il peut être très bref, mais avoir de très nombreuses et longues références. Dans le corps de l'article la référence est accédée par un rappel; donc ici avec ce modèle Ref avec un identifiant-clef manuel défini en paramètre positionnel 3.
Cette localisation des références permet de faire la cascade de références; mais de façon pas très compliquée et cependant réputée peu maintenable par la suite:

  • {{Ref|||HD}}bla...bla[Rd 1]...bli
  • {{Ref||L|HC}}bli...bli[Rc 1]...blo
  • {{Ref||grec|HB}}blo...blo[Rb 1]...blu
  • {{Ref||alpha|HA}}blu...blu[Ra 1]...blé
Ra {{Références|groupe=Ra|références= {{Ref|cité par {{Harvsp|auteurAR|2018|p=1}} {{Ref|en citation par {{Harvsp|auteurBR|2018|p=2}} {{Ref|selon {{Harvsp|auteurCR|2018|p=3}} {{Ref|repris par {{Harvsp|auteurDR|2018|p=4}} |Rd|RD}} |Rc|RC}} |Rb|RB}}|Ra|RA}} }}
  1. cité par auteurAR 2018, p. 1 [Rb 1]
Rb {{Références|groupe=Rb|références= }}
  1. a et b en citation par auteurBR 2018, p. 2 [Rc 1]
Rc {{Références|groupe=Rb|références= }}
  1. a et b selon auteurCR 2018, p. 3 [Rd 1]
Rd {{Références|groupe=Rb|références= }}
  1. a et b repris par auteurDR 2018, p. 4

Actuellement[note 1], cette manière de faire ne fait pas l'unanimité des contributeurs, malgré son utilité dans des cas d'articles spécialisés "pointus", elle est notamment décriée par une catégorie de "mainteneurs d'article" et disqualifiée pour la mise sous label de votre article.

Erreurs de saisie répertoriéesModifier

indication des erreurs de saisie et des appels anciens inadaptés[note 2]

--erreur de saisie de paramétrage (simulé){{Ref|bla bla = égal...en trop|L|h}}
Ceci est générateur d'un paramètre nommé bla bla dans le texte en renvoi en bas de page. Il est à remplacer par {{=}} s'il s'agit de texte et non d'appel à un modèle; Puisqu'il n'y a pas alors de paramètre positionnel 1, mais paramètres positionnels 2 groupe |L et 3 nom |h message de groupe manquant h :
Erreur de référence : Des balises <ref> existent pour un groupe nommé « h », mais aucune balise <references group="h"/> correspondante n’a été trouvée, ou bien une balise fermante </ref> manque

--erreur du même ordre de saisie de paramétrage{{Ref|bla bla = égal...en trop dans le texte en renvoi en bas de page; Erreur que vous pouvez voir par le message simple, cas qui a pu être attrapé par le module|E}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[7]

--erreur de saisie {{Ref| répète voir...en trop de paramètres positionnels même vides|L|i||}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[L 7]

--en trop: texte {{Ref|texte=ttt}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|Erreur de référence : La balise ouvrante <ref> est mal formée ou a un mauvais nom.
nb erreurs: 1
[[]] Avertissement: paramètre 'texte' valeur: (ttt) non pris en compte sous modèle Ref, utiliser modèle {{Note}} ou {{Sfn}}.


--en trop: groupe {{Ref| groupe...en trop|groupe=ggg}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[8]

--en trop: nom {{Ref| nom...en trop |nom=nnn}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[9]

--en trop: id {{Ref| id...en trop |L|m|id=iii}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[L 8]

--en trop: url {{Ref| url...en trop |L|n|url=uuu}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[L 9]

--en trop: un paramètre nommé {{Ref| un paramètre nommé...en trop |L|o|consulté le=ccc}} Erreur dans les paramètres wikicode du renvoi en bas de page ("Édition source" doit être utilisée, non pas "Éditeur visuel" (-pas de "clic"-)|[L 10]

Références et notes des exemplesModifier

Références
  1. a et b répète voir...
  2. a b et c répète voir...
  3. a b c et d répète voir...
  4. [[#cite_ref-texte1_'_15-0|↑]] texte1 [[#cite_note-texte2_'-14|[b]]]
  5. ouvrage1c auteurS, le livre S, [c]
  6. a et b cité par auteurS 2018, p. 1 [d]

  7. nb erreurs: 1
    [[]] Avertissement: id_paramètre bla bla valeur: (égal...en trop dans le texte en renvoi en bas de page; Erreur que vous pouvez voir par le message simple, cas qui a pu être attrapé par le module) en erreur sous modèle {{Ref}}.
    E

  8. nb erreurs: 1
    [[]] Avertissement: id_paramètre 'groupe' valeur: (ggg) non pris en compte sous modèle Ref, utiliser modèle {{Note}} ou {{Efn}} ou {{Sfn}}.
    groupe...en trop

  9. nb erreurs: 1
    [[]] Avertissement: paramètre 'nom' valeur: (nnn) non pris en compte sous modèle Ref, utiliser modèle {{Note}} ou {{Efn}}.
    nom...en trop
Références groupe L
  1. a et b répète voir...
  2. répète voir!
  3. a et b abcdef
  4. a et b texte4
  5. ouvrage4c auteurL, le livre L,
  6. a et b repris par auteurL 2018, p. 4

  7. nb erreurs: 2
    [[]] Avertissement: id_paramètre 4 valeur: () en erreur sous modèle {{Ref}}.
    Avertissement: id_paramètre 5 valeur: () en erreur sous modèle {{Ref}}.
    répète voir...en trop de paramètres positionnels même vides

  8. nb erreurs: 1
    [[]] Avertissement: id_paramètre 'id' valeur: (iii) non pris en compte sous modèle Ref, utiliser modèle {{Note}} ou {{Sfn}}.
    id...en trop

  9. nb erreurs: 1
    [[]] Avertissement: id_paramètre 'url' valeur: (uuu) non pris en compte sous modèle Ref, utiliser modèle {{Note}} ou {{Lien web}}.
    url...en trop

  10. nb erreurs: 1
    [[]] Avertissement: id_paramètre consulté le valeur: (ccc) en erreur sous modèle {{Ref}}.
    un paramètre nommé...en trop
Références groupe alpha
  1. répète voir...
  2. [[#cite_ref-texte2_'_14-0|↑]] texte2 [[#cite_note-texte3_'-13|[β]]]
  3. ouvrage2c auteurA, le livre A, [γ]
  4. a et b en citation par auteurA 2018, p. 2 [δ]
Références groupe grec
  1. répète voir...
  2. [[#cite_ref-texte3_'_13-0|↑]] texte3 [L 4]
  3. ouvrage3c auteurG, le livre G, [L 5]
  4. a et b selon auteurG 2018, p. 3 [L 6]
Références groupe à-noter
  1. Wikipédia depuis ses débuts prend des formes diverses (interviews de tous les contributeurs [référence 1])
  2. Wikipédia depuis ses débuts prend des formes diverses (interviews de tous les contributeurs [référence 1])
Bibliographie imaginaire

Le code:
{{Ouvrage|auteur=Hauteur|lien auteur1=Aide:Débuter|responsabilité1=Savoir et Faire savoir|auteur institutionnel=[[Wikipédia]]|titre=Les temps de Wikipédia|sous-titre=Les différents tempi|chapitre=Contribuez, contribuez, il en restera toujours quelque-chose...|année=2018|éditeur=En première ligne|id=Hauteur2018}}
Le rendu:
Hauteur (Savoir et Faire savoir), Wikipédia, Les temps de Wikipédia : Les différents tempi, En première ligne, , « Contribuez, contribuez, il en restera toujours quelque-chose... »

Références groupe référence portant sur la bibliographie imaginaire
  1. a b et c Hauteur 2018, tome II, chapitre 3, p.168

NotesModifier

  1. Révision de cette documentation: 3 mai 2018.
  2. Les appels anciens étaient une redirection (dure) du modèle Ref sur le modèle Note.

Voir aussiModifier

  • module {{Modèle:RefDetail}} avec nom de la référence à réutiliser obligatoire et option texte du détail.

Media WikiModifier

Renvoi en bas de page 1 2 3 avec paramètres non nommés positionnels. -Texte à mettre en renvoi: position 1. -Groupement: position 2. groupement alpha ([a], [b],...) grec ([α], [β],...), ref (ref 1, ref 2,...) index de regroupement choisi: auteur, site, ouvrage... -Identifiant pour rappel: position 3. Le rappel automatique est fait avec un copier-coller

Paramètres du modèle

La mise en forme multiligne est préférée pour ce modèle.

ParamètreDescriptionTypeStatut
texte obligatoire pour la première instance (la position de cette instance dans le texte de l'article importe peu)1

Corps du renvoi en bas de page

Exemple
Bonnes références exigées pour cet emploi.
Chaînesuggéré
groupe2

groupement alpha ([a], [b],...) grec ([α], [β],...), ref (ref 1, ref 2,...) index de regroupement choisi: auteur, site, ouvrage...

Exemple
AuteurX
Chaînesuggéré
nom identifiant (le rappel automatique peut-être aussi obtenu par un duplicata d'appel)3

identifiant pour rappel

Exemple
AuteurX.p.132
Chaînesuggéré