Modèle:Ref

Une page de Wikipédia, l'encyclopédie libre.
Sauter à la navigation Sauter à la recherche

 Documentation[modifier] [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é! —

Syntaxe[modifier le code]

{{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.

Exemples[modifier le code]

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

-et en un mouvement on peut développer en bas de page une source particulière pour une référence particulière{{Ref|{{Lien web |url= https://www.cairn.info/revue-imaginaire-et-inconscient-2001-1-page-25.htm |titre= L'imaginaire dans la culture occidentale |auteur=Natanson Jacques|date= 2001 |site= cairn.info|éditeur= Université de Rouen Membre associé du G.I.R.E.P. 450, Allée du Clair Vallon 76230 Bois Guillaume|citation=“Le cogito de la rêverie s’énonce ainsi : je rêve le monde donc le monde est comme je le rêve !” Bachelard G. (1961). La Poétique de la rêverie. Paris : P.U.F. p.136.|consulté le=28/04/2018}}}}[4]

-Une imbrication est possible, c'est une deuxième version de l'exemple précédent; (Il est d'usage répandu de choisir des groupes de renvoi différents pour les renvois contenus, pour cela voir ci-après Les appels imbriqués):
{{Ref|[Je souhaite imbriquer une référence sur G. Bachelard pour son aspect actuel:]{{citation|Le cogito de la rêverie s’énonce ainsi : je rêve le monde donc le monde est comme je le rêve !}}{{Harvsp|Bachelard|1961|p=136}}, (cité par [[Jacques Natanson (professeur)|Jacques Natanson]] {{Ref|{{Lien web |url= https://www.cairn.info/revue-imaginaire-et-inconscient-2001-1-page-25.htm |titre= L'imaginaire dans la culture occidentale |auteur=Natanson Jacques|date= 2001 |site= cairn.info|éditeur= Université de Rouen Membre associé du G.I.R.E.P. 450, Allée du Clair Vallon 76230 Bois Guillaume|consulté le=28/04/2018}}.[Dans la référence qui vient d'être décrite, j'ai emboité ceci pour corroborer le sens de la partie du texte d'article référencé, cela arrive au-dessus.]}}). }} [6]
--L'ouvrage est décrit dans le renvoi en bas de page suivant:
{{Ref|{{ouvrage |nom1= Bachelard |prénom1= Gaston |lien auteur1= Gaston Bachelard |titre= La poétique de la rêverie |numéro d'édition= 8 |éditeur= [[Presses universitaires de France]] |lieu= Paris |année= 1984 |pages totales= 183 |Collection= Quadrige |ISSN= 0291-0489 |bnf= FRBNF34764842 |id=Bachelard1961}} }} [7]

Les appels imbriqués[modifier le code]

clef automatique

-Ref imbriquées (de texte simple):
{{Ref|texte1 {{Ref|texte2 {{Ref|texte3 {{Ref|texte4 |L}} |grec}} |alpha}} }} [8]

-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 }}[9]

-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}} [10]

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

Les sources reconnues pour faire référence[modifier le code]

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]
  2. 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]
    2. Rb {{Références|groupe=Rb|références= }}
      1. a et b en citation par auteurBR 2018, p. 2 [Rc 1]
      2. Rc {{Références|groupe=Rb|références= }}
        1. a et b selon auteurCR 2018, p. 3 [Rd 1]
        2. Rd {{Références|groupe=Rb|références= }}
          1. a et b repris par auteurDR 2018, p. 4
          2. 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ées[modifier le code]

            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"-)|[11]

            --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"-)|[12]
            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"-)|[13]

            --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"-)|[14]

            --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 exemples[modifier le code]

            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. Natanson Jacques, « L'imaginaire dans la culture occidentale », sur cairn.info, Université de Rouen Membre associé du G.I.R.E.P. 450, Allée du Clair Vallon 76230 Bois Guillaume, (consulté le 28 avril 2018) : « “Le cogito de la rêverie s’énonce ainsi : je rêve le monde donc le monde est comme je le rêve !” Bachelard G. (1961). La Poétique de la rêverie. Paris : P.U.F. p.136. »
            5. Natanson Jacques, « L'imaginaire dans la culture occidentale », sur cairn.info, Université de Rouen Membre associé du G.I.R.E.P. 450, Allée du Clair Vallon 76230 Bois Guillaume, (consulté le 28 avril 2018).[Dans la référence qui vient d'être décrite, j'ai emboité ceci pour corroborer le sens de la partie du texte d'article référencé, cela arrive au dessus.]
            6. [Je souhaite imbriquer une référence sur G. Bachelard pour son aspect actuel:]« Le cogito de la rêverie s’énonce ainsi : je rêve le monde donc le monde est comme je le rêve ! »Bachelard 1961, p. 136, (cité par Jacques Natanson[5]).
            7. Gaston Bachelard, La poétique de la rêverie, Paris, Presses universitaires de France, , 8e éd., 183 p. (ISSN 0291-0489, notice BnF no FRBNF34764842)
            8. texte1 [b]
            9. ouvrage1c auteurS, le livre S, [c]
            10. a et b cité par auteurS 2018, p. 1 [d]

            11. 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
            12. Erreur de référence : Balise <ref> incorrecte ; aucun texte n’a été fourni pour les références nommées

            13. 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

            14. 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. texte2 [β]
            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. 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

            Notes[modifier le code]

            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 aussi[modifier le code]

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

            Media Wiki[modifier le code]

            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

            Ce modèle possède une mise en forme utilisateur.

            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

            Par défaut
            vide
            Exemple
            Bonnes références exigées pour cet emploi.
            Valeur automatique
            vide
            Chaînesuggéré
            groupe2

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

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

            identifiant pour rappel

            Par défaut
            vide
            Exemple
            AuteurX.p.132
            Valeur automatique
            vide
            Chaînesuggéré