Aller au contenu

Modèle:R/Documentation

Définition, traduction, prononciation, anagramme et synonyme sur le dictionnaire libre Wiktionnaire.
Version datée du 10 novembre 2023 à 11:28 par Stephane8888 (discussion | contributions) (essai de clarification)
info Documentation du modèle

Utilisation

Ce modèle sert à créer un renvoi vers une référence depuis le corps de l’article. Il sert donc à référencer une information précise.

Syntaxe

Il convient de faire suivre les informations à référencer par ce type de syntaxe : {{R|étiquette}}. Par exemple : {{R|Auteur}} ou {{R|Machin}}, etc. Cela affichera un petit numéro pointant vers la référence correspondante dans la section === {{S|références}} ===. Cette dernière ayant par exemple la syntaxe suivante :

=== {{S|références}} ===
<references>
{{R|étiquette|description de la référence}}
{{R|Auteur|Auteur, ''Titre'', Éditeur, Année, n° de la page}}
{{R|Machin|{{w|Jean Machin}}, ''Vivre ou survivre'', Bornemann, 2009, page 39}}
</references>

Remarque : L’utilisation de ce modèle {{R}} se fait au niveau de l’information à référencer et dans la section Références en bas de l’article. Dans les deux cas, le premier paramètre est le nom de l’étiquette choisie. La seconde utilisation du modèle, dans la section référence donc, admet un second paramètre décrivant la référence.

Comme étiquette, vous êtes libre du choix, mais il est préférable de prendre un nom compréhensible : le nom de l’auteur de l’ouvrage, ou celui de l’auteur principal, ou à défaut celui du nom de l’ouvrage, en précisant si besoin l’année. Exemple : Jean Giono, Montesquieu, Union européenne, Revue musicale, Quid 1987, etc.

Enfin, certains noms d’étiquette sont déjà utilisés par des modèles prédéfinis, leur comportement est décrit ci-après.

Important : Si {{R}} n’apparaît que dans la section Références, il y aura une erreur comme celle illustrée plus bas.

Cas particulier des modèles prédéfinis {{R:Auteur}}

Un certain nombre de modèles de références existent déjà sur le Wiktionnaire : {{R:TLFi}}, {{R:Littré}}, {{R:Gaffiot}}, etc. Ces modèles servent à référencer globalement un article.

Lorsque vous codez {{R|TLFi}}, la description de l’ouvrage TLFi contenue dans le modèle {{R:TLFi}} va être automatiquement récupérée. Certains modèles {{R:Auteur}} affichent même un lien direct vers l’article de l’ouvrage en question. Exemple :

Vous placez dans l’article caramel l’étiquette {{R|TLFi}} derrière l’information à référencer, et vous codez à la fin :

<references>
{{R:TLFi}}
</references>

un petit [1] s’affichera derrière l’information à référencer et pointera vers la section Références qui affichera :

Notez le lien qui pointe vers l’article caramel du TLFi.

Avertissement : Quand on crée un nouveau modèle nommé {{R:xxxxx}}, on doit chercher des liens vers ce modèle par Spécial:Pages liées/Modèle:R:xxxxx ou par Spécial:Recherche/insource:"R xxxxx". S’il y en a au moins un, il faut éviter ce nom de modèle.

{{R}} peut passer jusqu’à deux arguments au modèle référencé, qui les traitera à sa façon.

Le paramètre r pour « répétition »

Si le paramètre r de {{R}} est instruit, cela indique que cette instance est une répétition d’une précédente. Seul les paramètres 1 et 2 sont alors pris en compte. Par exemple, au lieu de :

'''manne''' {{pron|mɑn|fr}}{{R|Traité complet de la prononciation française 1871|25|:<br 
/>''Dans le mot '''''manne''''' (suc mielleux de certains végétaux ; nourriture tombée du ciel), '''an''' se prononce '''a''' ''long : mâne.}} {{f}}
[…]
* ''([[#fr-nom-1|Nom 1]])'' [[mâne]]{{R|Traité complet de la prononciation française 1871|25|:<br 
/>''Dans le mot '''''manne''''' (suc mielleux de certains végétaux ; nourriture tombée du ciel), '''an''' se prononce '''a''' ''long : mâne.}}
[…]
=== {{S|références}} ===
{{références}}

on pourra écrire :

'''manne''' {{pron|mɑn|fr}}{{R|Traité complet de la prononciation française 1871|25|:<br 
/>''Dans le mot '''''manne''''' (suc mielleux de certains végétaux ; nourriture tombée du ciel), '''an''' se prononce '''a''' ''long : mâne.}} {{f}}
[…]
* ''([[#fr-nom-1|Nom 1]])'' [[mâne]]{{R|Traité complet de la prononciation française 1871|25|r=1}}
[…]
=== {{S|références}} ===
{{références}}

Ce qui donnera :

manne \mɑn\[1] féminin […]

[…]

Références

  1. a et b M.-A. Lesaint, Traité complet de la prononciation française dans la seconde moitié du XIXe siècle, Wilhelm Mauke, Hambourg, 1871, seconde édition entièrement neuve, p. 25 :
    Dans le mot manne (suc mielleux de certains végétaux ; nourriture tombée du ciel), an se prononce a long : mâne.

… et lien vers un article autre que le mot vedette

Il est possible de pointer sur un autre mot que le mot vedette : Exemple : avec {{R|Gaffiot|neutralis}}, affichant [1] dans l’article neutralité :

<references>
{{R|Gaffiot|neutralis}}
</references>

donne

  1. Félix GaffiotDictionnaire latin français, Hachette, 1934 → consulter cet ouvrage

L’expression {{R|Gaffiot|neutralis}} doit apparaître aux deux endroits.

… et lien vers plusieurs articles autre que le mot vedette d’une même référence

Toujours dans le cas de ces modèles de références prédéfinis qui donnent un lien vers la page de l’ouvrage en question (ex. {{R:Littré}}, {{R:TLFi}}, {{R:DAF8}}, {{R:Reverso}}, etc.).

Il est possible de pointer vers plusieurs de leurs articles, autre que le mot vedette :
Exemple : avec {{R|Gaffiot|neutralis}} et {{R|Gaffiot|neuter}} affichant [1] et [2] dans l’article neutralité :

Exemple :

<references>
{{R|Gaffiot|neutralis}}
{{R|Gaffiot|neuter}}
</references>

donne

  1. Félix GaffiotDictionnaire latin français, Hachette, 1934 → consulter cet ouvrage
  2. Félix GaffiotDictionnaire latin français, Hachette, 1934 → consulter cet ouvrage

Résolution d’éventuels problèmes d’affichage

Vérifiez qu’il y ait bien correspondance entre une étiquette {{R|Auteur}} et une ligne :

<references>
{{R|Auteur}}
</references>

Concernant les URL et le « = »

alt = attention Pour l’affichage de liens vers des pages web, si votre argument inclut un signe égal (« = ») comme celle-ci[1], il faut impérativement préfixer l’argument de 2= (c’est-à-dire utiliser la seconde syntaxe). Par exemple, on peut écrire :

<references>
{{R|Létourneau|2=Journal de Lorenzo Létourneau (1899), [http://www.qualigram.ca/qualigram/index.php?id=12276 ''17 Eldorado''], Qualigram/Linguatech, Montréal, 2006}}
</references>

qui donnera :

  1. Journal de Lorenzo Létourneau (1899), 17 Eldorado, Qualigram/Linguatech, Montréal, 2006

mais pas

<references>
{{R|Létourneau|Journal de Lorenzo Létourneau (1899), [http://www.qualigram.ca/qualigram/index.php?id=12276 ''17 Eldorado''], Qualigram/Linguatech, Montréal, 2006}}
</references>

car ce dernier donnera l’erreur suivante :

Erreur de référence : La balise <ref> avec le nom « Létourneau » définie dans le groupe <references> «  » n’a aucun contenu.

Voir aussi