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 group="yyyy" name="xxxx">...</ref>

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

Ce modèle fournit un renvoi en bas de page avec rappel automatique s'il est dupliqué.
Il supporte les imbrications.
Il est réduit

• au paramètre du texte en renvoi, doit exister au moins une fois,
• au paramètre facultatif du lien de groupe qui est affiché pour son appel dans l'article et nécessite que l'on utilise un modèle d'affichage du renvoi {{Références}} ou {{Notes}},
• 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 porte sur les 3 paramètres positionnels c-à-d 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 [+]

• Catégorie:Modèle Ref avec paramètre défaillant

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é! —

• Rq: Comme pour tous les modèles à paramètres positionnels, la position constitue un alias pour l'écriture de {{Ref}}
  {{Ref|3=identifiant|1=texte en renvoi}} est la même chose que {{Ref|texte||identifiant}}

Syntaxe

{{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. Vous pouvez s'il y a imbroglio utiliser le paramètre nommé trace à la fin du code (voir infra)

Exemples

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

-simple bis (dupliqué) {{Ref|répète voir...}}

-avec nom (vouloir le séparer des 2 premiers obtenus par copié-collé) {{Ref|répète voir...||machin}}
Remarquez qu'il n'a pas plus de groupe qu'au-dessus mais qu'il y a un nom
-avec nom bis (dupliqué) {{Ref|répète voir...||machin}}
-et obtenir le rappel avec ce nom{{Ref|||machin}}
-- ou bien rappel comme ça:{{Ref|3=machin}}

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

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

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

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

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

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

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

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

-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}}
--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}})|groupe=à-noter}}
---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|3=A|2=référence}})|groupe=à-noter}}

Les appels imbriqués

clef manuelle

-Ref imbriquées d'appels en cascade pour des ouvrages c-à-d pas de bibliographie :

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

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

{{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|HL}} |grec|HG}} |alpha|HA}} ||HS}} donne:

-Références en rappel d'une cascade -ici Harvsp-. Ils peuvent être faits à tout niveau (clés manuelles). Dans cet exemple, elles génèrent toutes un b de rappel dans l'espace référence:

• {{Ref|||HS}}
• {{Ref||L|HL}}
• {{Ref||grec|HG}}
• {{Ref||alpha|HA}}

Rq: L'introduction du paramètre nommé "ps" dans {{Sfn}} permet une cascade plus facile avec un peu d'expérience et plus courte à écrire.

-Utilisation de la définition des références dans l'espace référence et (r)appel dans le corps de l'article.
Notez bien: Le ref imbriqué sous l'espace Référence est lui même atteignable seulement en écrivant le groupe en position 2 avec le nom en position 3. L'ordre d'apparition dans le texte de l'article est celle de l'espace référence ce qui n'est pas habituel.

{{ref||Wik|Couic}} {{ref||Wik|imbriqué sous groupe Wik}}<br>
--
{{Références|groupe=Wik|références=
{{ref|Y aurait-il eu un ''wikipédia''{{ref|Il y avait préalablement une [[encyclopédie universelle]], mais si on avait pas inventé l'[[imprimerie]]?|Wik|imbriqué sous groupe Wik}} si on avait pas inventé {{Source insuffisante|l'électricité domestique|date=4 mars 2020}}?|Wik|Couic}}
}}

donne:

--

Pour retrouver dans une situation compliquée une trace de ses petits renvois

Le paramètre nommé trace= sert à comprendre quelle est la logique du système de renvoi(s).

La base

• {{ref|La neige est prévue pour les vacances de fin d'année.}} donne
• le bis avec un nom: {{ref|La neige est prévue pour les vacances de fin d'année.||flocon}} donne
• {{ref|La neige est prévue pour les vacances de fin d'année.|trace=oui}} donne
  • <ref>La neige est prévue pour les vacances de fin d'année.</ref> Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin. Rq: les sauts de ligne sont normaux
• {{ref|La neige est prévue pour les vacances de fin d'année.||flocon|trace=oui}} donne
  • <ref name="flocon">La neige est prévue pour les vacances de fin d'année.</ref> Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin. Rq: les sauts de ligne sont normaux
• et maintenant avec un groupe et un nom {{ref|La neige est prévue pour les vacances de fin d'année.|grec|flocon|trace=oui}} donne
  • <ref group="grec" name="flocon">La neige est prévue pour les vacances de fin d'année.</ref> Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin. Rq: les sauts de ligne sont normaux
    • Astuce: copier-coller les balises du code ci-dessus <ref group="grec" name="flocon">La neige est prévue pour les vacances de fin d'année.</ref> donne le (r)appel avec les balises: Rq: Il n'y aura pas d'erreurs de constitution des balises...si vous les préférez plutôt que le modèle Ref.

Situation qui a l'air compliquée

--Pas forcément besoin de la trace:

• {{ref|La neige est prévue pour les vacances de fin d'année, ça m'est "=" je reste au chaud.||flocon}} donne
  • ERREUR pas de texte pas de nom (mais un groupe) en paramètres positionnels ou bien un paramètre nommé ou bien un = dans le texte du renvoi. Utilisez = si besoin. Rq: il n'y a pas du tout de balises HTML qui ont été traduites
• {{ref|La neige est prévue pour les vacances de fin d'année, ça m'est "=" je reste au chaud.||flocon|trace=oui}} donne
  • ERREUR pas de texte pas de nom (mais un groupe) en paramètres positionnels ou bien un paramètre nommé ou bien un = dans le texte du renvoi. Utilisez {{=}} si besoin. Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin.ERREUR pas de texte pas de nom (mais un groupe) en paramètres positionnels ou bien un paramètre nommé ou bien un = dans le texte du renvoi. Utilisez = si besoin. Rq: il n'y a pas traduction par le module de balises HTML
    
    

--La trace peut servir (dans un article initial éclaté en plusieurs actuels) car le renvoi à l'air absurde dans l'article modifié

• {{ref|||flaque|trace=oui}} donne
  • <ref name="flaque"/> Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin. Rq: il n'y a pas traduction complète des balises HTML et un message d'erreur est émis comme renvoi en bas de page, et pas à la toute fin de l'article
    
    

--La trace est utile dans un article compliqué qui comporte des imbrications comme celles décrites dans la section ci-dessus

• {{Ref|trace=OUI|cité par {{Harvsp|auteurS|2018|p=1}} {{Ref|trace=|en citation par {{Harvsp|auteurA|2018|p=2}} {{Ref|trace=|selon {{Harvsp|auteurG|2018|p=3}} {{Ref|trace=|repris par {{Harvsp|auteurL|2018|p=4}} |L|RC}} |grec|RB}} |alpha|RA}}||RD}} donne
  • <ref name="RD">cité par auteurS 2018, p. 1 </ref> Rappel: ne pas mettre de = dans le code de paramètres positionnels. Utilisez {{=}} si besoin. Rq: Pour les appels internes on affiche une cascade de catastrophe(s) due(s) à la balise </ref> absente! Ceci dit cela peut donner une idée de l'indentement...
    

Les sources reconnues pour faire référence

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

référence affichée par: {{Références|groupe=JH}}

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...bli
• {{Ref||L|HC}}bli...bli...blo
• {{Ref||grec|HB}}blo...blo...blu
• {{Ref||alpha|HA}}blu...blu...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}}

}} donne

Rb {{Références|groupe=Rb|références= }} donne

en citation par auteurBR 2018, p. 2

Rc {{Références|groupe=Rc|références= }} donne

selon auteurCR 2018, p. 3

Rd {{Références|groupe=Rd|références= }} donne

repris par auteurDR 2018, p. 4

Actuellement, 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

indication des erreurs de saisie et des appels anciens inadaptés

--en trop: texte {{Ref|texte=ttt}} [[]]
nb erreurs: 1
ERREUR argument nommé texte= ou text=;Remplacez ce modèle avec {{Note}}, avec {{Efn}}. Utilisez {{=}} si besoin.


--en trop: groupe {{Ref| groupe...en trop|groupe=ggg}} [[]]
nb erreurs: 1
ERREUR argument nommé groupe= ou group=;Remplacez ce modèle avec {{Note}}, avec {{Efn}}. Utilisez {{=}} si besoin.


--en trop: nom {{Ref| nom...en trop |nom=nnn}} [[]]
nb erreurs: 1
ERREUR argument nommé nom= ou name=;Remplacez ce modèle avec {{Note}}, avec {{Efn}}. Utilisez {{=}} si besoin.


--en trop: id {{Ref| id...en trop |L|m|id=iii}}

--en trop: url {{Ref| url...en trop |L|n|url=uuu}}

--en trop: un paramètre nommé {{Ref| un paramètre nommé...en trop |L|o|consulté le=ccc}}
--on se trompe de groupe{{ref| Groupe n'est pas groupe |Groupe|Couic}} <references group=groupe>

Références et notes des exemples

Références

Références groupe L

Références groupe alpha

Références groupe grec

Références groupe à-noter

a)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, 2018, « Contribuez, contribuez, il en restera toujours quelque-chose... »

Références groupe référence portant sur la bibliographie imaginaire

b)Bibliographie imaginaire pour exemples codes imbriqués dans les renvois

• auteurAR, LivreA : Modèle:Ref/Documentation, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurBR, LivreB : Modèle:Ref/DocumentationII, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurCR, LivreC : Modèle:Ref/DocumentationIII, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurDR, LivreD : Modèle:Ref/DocumentationIV, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurER, LivreE : Modèle:Ref/DocumentationV, Editeur code Wiki, 2021, « (Livre sans lien) »

• auteurS, Livre S : Ref/Documentation, Editeur code Wiki, 2011, « (Pas de lien sans issue) »
• auteurA, Livre A : Ref/Documentation, Editeur code Wiki, 2012, « (Pas de lien sans issue) »
• auteurG, Livre G : Ref/Documentation, Editeur code Wiki, 2013, « (Pas de lien sans issue) »
• auteurL, Livre L : Ref/Documentation, Editeur code Wiki, 2014, « (Pas de lien sans issue) »

• auteurU, Livre U : bricolage, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurV, Livre V : bricolage, Editeur code Wiki, 2021, « (Pas de lien sans issue) »
• auteurW, Livre W : bricolage, Editeur code Wiki, 2021, « (Pas de lien sans issue) »

Voir aussi

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

Media Wiki

Renvoi en bas de page 1 2 3 avec paramètres non nommés positionnels, paramètre nommé trace. -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 si renvoi nommé avec le positionnel 3

Paramètres du modèle[Modifier les données du modèle]

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

Paramètre		Description	Type	État
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îne	suggéré
groupe	2	groupement alpha ([a], [b],...) grec ([α], [β],...), ref (ref 1, ref 2,...) index de regroupement choisi: auteur, site, ouvrage... Exemple AuteurX	Chaîne	suggéré
nom identifiant (le rappel automatique peut-être obtenu par un duplicata d'appel avec un nom identifiant)	3	identifiant pour rappel Exemple AuteurX.p.132	Chaîne	suggéré
trace	trace	fournit l'expression des balises HTML Exemple trace=oui	Chaîne	facultatif

La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.