Discussion modèle:R/Documentation

Auteur et nom de l'ouvrage

@Stephane8888 : Bonjour et merci pour toute votre contribution à cette page.

Pouvez-vous expliquer l'intérêt (ou la nécessité?) qu'il y aurait de passer 2 fois l'auteur en paramètre?

De plus, par rapport à votre précision sur l'étiquette Auteur, l'utilisation du nom de l'ouvrage ne fait pas de sens comme auteur puisque :

1. Le nom de l'ouvrage (sauf cas exceptionnel) ne décrit pas l'auteur.
2. Le nom de l'ouvrage est précisément l'étiquette suivante de l'énumération, donc ce serait une répétition.

Finalement, il serait beaucoup plus clair de séparer le ou les gabarits des exemples. Chealer (discussion) 28 octobre 2023 à 10:51 (UTC)

@Chealer : Bonjour. Passer 2 fois l’auteur en paramètre ? J’imagine que vous parlez de cette syntaxe {{R|Auteur|Auteur,

C’est dans le cas le plus courant où le nom de l’auteur sert d’étiquette. Mais c’est pas très clair en effet. Le premier "Auteur" est une étiquette, seulement utile au renvoi. Le second "Auteur" est le nom complet de l’auteur (Prénom Nom) avec éventuellement un lien vers Wikipédia.

Concernant votre remarque au sujet du nom de l’ouvrage choisit comme étiquette : C’est typiquement quand plusieurs ouvrages d’un même auteur servent de référence à une page. Ou qu’on ne connait pas l’auteur, s’agissant d’un collectif, etc. Par exemple dans l’article mûroise, les 4 étiquettes choisies n’utilisent pas un nom d’auteur.

Je n’ai pas compris votre proposition, mais si vous pensez rendre plus claire la documentation : N’hésitez pas. Stephane8888 ✍ 29 octobre 2023 à 21:02 (UTC) P.S. : J’ajoute que l’étiquette est seulement visible dans l’url d’appel.

@Stephane8888 : Oui, c'est ce que je voulais dire.

Merci de la clarification, mais si l'« étiquette » est seulement utilisée comme paramètre d'URL, êtes-vous d'accord qu'il ne s'agit pas véritablement d'une étiquette (puisqu'elle n'est pas vraiment visible)?

Pour la séparation entre gabarits et exemples, je parle par exemple du fragment suivant : {{R|Auteur|Auteur, ''Nom de l’ouvrage'', Éditeur, 2010, page 123}}. Il ne s'agit ni d'un gabarit (puisqu'on y retrouve des valeurs bidon comme 2010 et 123), ni d'un exemple (puisqu'on y retrouve des placeholders génériques comme Auteur et Éditeur), mais d'un hybride entre les 2.

La forme la plus claire pour documenter un modèle à plusieurs paramètres comme celui-ci est sans doute un tableau, ce qui permet d'indiquer pour chaque paramètre à la fois un nom, une description et des exemples. --Chealer (discussion) 3 novembre 2023 à 12:16 (UTC)

@Chealer : L’« étiquette » n’est qu’un lien entre l’appel à la référence dans le corps de l’article et la référence elle-même dans la section référence. Le mot "étiquette" n’est peut-être pas le bon : "tag" ? "label" ? "clé" ? "index" ? "index" serait meilleur effectivement. J’ai un peu modifié la doc.

Pour la description du modèle, le tableau est une bonne idée. Mais ce modèle n’a que deux paramètres : le premier est l’"étiquette", le second est la description de la référence. Donc idéalement avec l’auteur, le titre, etc. Là aussi j’ai essayé de clarifier la doc. Stephane8888 ✍ 10 novembre 2023 à 13:26 (UTC)

Hum. Plus je regarde la documentation, moins j'ai l'impression de comprendre. Ce modèle a au moins 3 paramètres, non? La section Le paramètre r pour « répétition » montre même plusieurs exemples en utilisant 3 simultanément. Chealer (discussion) 12 novembre 2023 à 14:46 (UTC)