Discussion aide:TemplateData

Sous-page documentation ?

Tout d'abord, merci pour la clarté du tutoriel. Ensuite un question : que faire quand un modèle n'a pas de sous-page de documentation ? Par exemple Modèle:Base Mérimée. HB (d) 21 juillet 2013 à 15:46 (CEST)

S'il n'y a pas de sous-page de documentation, on peut mettre les TemplateData directement sur la page du modèle (dans les tags <noinclude>, avec le reste de la documentation). guillom 21 juillet 2013 à 18:48 (CEST)

J'ai testé rapidement en sous page de documentation, après près de 48 h le templateData que j'ai mis n'est toujours pas pris en compte. Le retard est vraiment conséquent, et il faut être admin pour faire les dummy edits sur les modèles les plus usités ... Loreleil ^[d-c] 22 juillet 2013 à 14:01 (CEST)

Bonjour, j'ai fait quelques tests pour des modèles que j'ai créé et je remarque qu'il y a quelques problème. J'ai mis en place, le weekend passé, le TemplateData sur le Modèle:Escalade ascensions notables par exemple. Et aujourd'hui rien n'est reconnu dans le Visual Editor, par contre on y voit toute les pages de documentations, ce qui est plutôt gênant. --Helg ^[discuter] 1 août 2013 à 11:24 (CEST)

Liens dans la description des paramètres

Enregistré sur Phabricator
Tâche 52656

Bonjour,

Actuellement, dans la documentation des infobox, il n'est pas rare de trouver des liens dans la description des paramètres pour expliciter plus clairement le rôle de certains paramètres (exemple). Or j'hésite un peu à remplacer cette section par un TemplateData car du coup on perd cette information. Peut-on y remédier ? Florn (d) 30 juillet 2013 à 23:30 (CEST)

La demande de fonctionnalité a été faite aux développeurs : bugzilla:50656. C'est une demande récurrente, donc je pense que ce sera fait assez rapidement. guillom 31 juillet 2013 à 09:42 (CEST)

Merci et bon courage. Florn (d) 31 juillet 2013 à 10:14 (CEST)

Wikilien fautif

Bonjour,

Dans la section Outil, il y a un wikilien vers un éditeur en JavaScript de Ltrlg. Manque-t-il un « .js » au wikilien ?

— Cantons-de-l'Est ^discuter 7 août 2013 à 04:20 (CEST)

Ordre des paramètres, valeurs imposées,…

Enregistré sur Phabricator
Tâche 55608 corrigé

Enregistré sur Phabricator
Tâche 53375

Bonjour, quelques questions à propos de TemplateData…

1. N'est-il pas possible de forcer, en entrant les données TemplateData, l'ordre d'apparition des paramètres du modèle dans l'ÉditeurVisuel ? Par exemple, avec {{Infobox Intercommunalité de France}}, les paramètres ont un ordre « logique », qui ne correspond pas à celui obtenu dans l'ÉV.
2. À quoi sert d'entrer des "sets" (après "description" et "params") ?
3. Quid de la possibilité éventuelle d'imposer une liste des valeurs possibles pour un paramètre ?

Merci d'avance. Auxerroisdu68 ^@ 27 septembre 2013 à 12:08 (CEST)

Bonjour, je pense que le meilleur moyen d'avoir toutes les réponses est de demander à NicoV, qui est beaucoup plus expérimenté que moi sur la question spécifique! --Elitre (WMF) (discuter) 14 octobre 2013 à 14:01 (CEST)

Pour moi, il faudrait que l'EV respecte par défaut l'ordre des paramètres tels que listés dans les données TemplateData. Si ce n’est pas le cas, c'est bien dommage car ne pas respecter un ordre logique va amener à avoir des articles difficilement maintenables pour les appels de modèles. Il y a déjà le bugzilla:53608 sur l'ordre des paramètres dans TemplateData, mais il faudrait quand même que l'EV utilise l'ordre des paramètres définis dans TemplateData pour les proposer dans cet ordre. Les "sets" servent à grouper les paramètres logiquement entre eux (cf. [1]) mais je ne sais pas si l'EV en tient compte. Pour les listes de valeur, il a bugzilla:51375. --NicoV (discuter) 14 octobre 2013 à 15:11 (CEST)

Quid des redirections

Enregistré sur Phabricator
Tâche 52964 corrigé

Bonjour,

Je viens d’essayer d’ajouter le TemplateData sur Modèle:Boîte Babel (j’espère ne pas avoir fait d’erreur, j’ai volontairement choisi un modèle peu utilisé pour commencer) tout fonctionne plutôt bien jusqu’à ce que je me rende compte que le TemplateData n’est pas pris en compte sur la redirection Modèle:Babel. Faut-il copier le TemplateData également sur la redirection ? (cela ne me semble pas très « élégant » comme solution…).

Cdlt, Vigneron * ^discut. 11 octobre 2013 à 19:52 (CEST)

Bonjour, je pense que cette question a été soulevée ici. Vous pouvez vérifier si cela répond à votre question? Je vous remercie! --Elitre (WMF) (discuter) 14 octobre 2013 à 13:57 (CEST)

Il y a le bugzilla:50964. --NicoV (discuter) 14 octobre 2013 à 15:18 (CEST)

Francisation

Serait-il possible de franciser templatedata ? Par exemple de pouvoir mettre "type": "nombre", "requis": oui ? 78.251.243.23 (discuter) 24 novembre 2013 à 01:57 (CET)

Raaaaaaah

Enregistré sur Phabricator
Tâche 106382 corrigé

 Trizek (WMF) : la page renvoie vers Bugzilla, alors j'écris ici. J'avais rempli une bonne vingtaine de paramètres quand j'ai eu le malheur de cliquer sur Retour deux fois au lieu d'une et ça m'a alors fermé promptement la fenêtre. Y-a-t-il moyen de demander confirmation ou de ne pas mettre les boutons au même endroit, ou de garder ça quelque part en cache ? — Kvardek du ^{(laisser un message)} le 21 juillet 2015 à 05:14 (CEST)

Ca m'est arrivé plusieurs fois, et c'est effectivement assez frustrant. J'ai soumis une tâche. Trizek (WMF) (discuter) 21 juillet 2015 à 16:53 (CEST)

Erreur de fermeture/retour

Bonjour,

Lorsque j'utilise TemplateData en mode visuel pour l'édition d'une infobox, que ce soit pour le modèle ou pour le détails des champs, si je clique sur fermer (croix X), ou que je fais Echap, la barre de chargement (du module dans la page) patine dans la semoule, et rien ne se passe après plusieurs minutes. Ce qui force à recharger toute la page et à perdre les modifications...

Pas de soucis en revanche avec Terminé/Appliquer.

Merci, Roumpf - [✉] 25 décembre 2019 à 20:38 (CET)

Paramètres valides volontairement non documentés dans le TemplateData ?

Bonjour. Les TemplateData ont deux rôles principaux :

1. indiquer quels paramètres sont valides dans un modèle donné ;
2. faciliter l'insertion du modèle dans un article via l'éditeur visuel.

Le premier point est ce qui sert aux outils de vérification et de signalement d'erreurs comme l'analyseur de WPCleaner ou le site d'Orlodrim wstat.fr/template (pour ce dernier, au moins pour les modèles reposant sur des modules Lua).

Du côté des modèles, on a quelques particularités pour certains paramètres :

• des paramètres valides mais qui ne devraient être utilisé qu'exceptionnellement (exemple : « nocat », « wikidata » des infobox) ;
• des paramètres dont l'utilité dépend de la présence d'autres paramètres, comme
  • « taille logo » inutile sans « logo ». C'est juste un exemple en considérant que le logo n'est pas sur Wikidata ou pas importé depuis Wikidata. D'autres exemples pour des paramètres exclusivement insérés en dur dans l'article existent.
  • « inauguration » qui n'est pas affiché si le modèle contient (et affiche) déjà un paramètre « ouverture ». Cela concerne {{Infobox Stade}} et plus généralement les infobox qui sollicitent le module Module:Infobox/Fonctions/Bâtiment.

Comment faire en sorte que les contributeurs n'insèrent pas des paramètres vides ou inutiles lors de l'insertion dans les articles sans pour autant pénaliser la maintenance en la rendant plus complexe ? Le risque de cette dualité ou plutôt du manque de clarté est que :

• d'une part les contributeurs peu experts hésitent à participer à la maintenance, par crainte de faire des bêtises ;
• d'autre part, inversement, des contributeurs zélés, par maladresse ou méconnaissance, retirent des paramètres valides, en se fiant à des TemplateData incomplets.

Comment faire au mieux pour l'encyclopédie ? Il existe des statuts : paramètre obligatoire, suggéré, obsolète. Faudrait-il créer un nouveau statut pour une utilisation peu conseillée ou exceptionnelle ? Ces paramètres techniques apparaîtraient d'une autre couleur ou même pas du tout dans l'éditeur visuel. Mais cela ne faciliterait pas le remplissage des TemplateData. Faut-il miser sur la pédagogie auprès du rédacteur en invitant à ne pas insérer de paramètre non recommandés vides (Aide:ÉditeurVisuel#Insérer des modèles) ?
Tractopelle-jaune, un avis ? — Ideawipik (discuter) 26 mars 2022 à 16:19 (CET)

Salut  Ideawipik,

Pour les paramètres type nocat, j'avais ajouté une sous-section dans les bonnes pratiques (Aide:TemplateData#Paramètres « nocat »).

Ce paramètre n'est utilisé qu'en dehors de l'espace encyclopédique, sur des pages de docs, d'aide, des sous-pages personnelles comme pense-bête, etc. Ce sont des espaces où de toute façon l'EV n'est que très rarement supporté, et encore moins utilisé.

Par contre, j'ai constaté de très nombreuses utilisations inappropriée de ce paramètre avec des modèles (surtout les bandeaux) quand ils étaient documentés. Les nouveaux étant parfois assez perturbés/dérangés par les bandeaux sur les articles, qu'ils essaient de les faire disparaître ou de les supprimer (à tort ou à raison), mais de manière parfois assez hasardeuse.

Vu le très faible nombre de paramètres de ces modèles de maintenance, il suffit d'aller dans les paramètres optionnels depuis l'EV pour le trouver et l'insérer.

Depuis quelque temps, sauf quelques exceptions, je ne le documente plus, et le supprime carrément des données TemplateData quand je l'y trouve (à noter que certains avaient été ajoutés par moi-même dans le passé).

Cela ne présente pas vraiment d'inconvénients pour la plupart des modèles. wstat.fr utilisant les données TemplateData uniquement pour les modèles Lua. Pour WPCleaner j'ignore tout de l'impact éventuel de cette pratique. Mais de mon point de vue, l'inconvénient est moindre que d'avoir ces paramètres accessibles depuis l'éditeur visuel.

On pourrait aussi marquer un tel paramètre avec le statut obsolète, cela permet de le laisser dans les données TD, mais il n'est plus possible de l'ajouter/modifier depuis l'EV si le paramètre n'était pas déjà présent. Mais je suis pas du tout fan de détourner ainsi le statut obsolète.

---

Pour les paramètres wikidata (cela concerne surtout des infobox), je le documente généralement dans TemplateData, car il est parfois légitimement utilisé dans certains articles (vu la segmentation de WD entre différents items, cela ne colle parfois parfois pas avec l'article lié, notamment pour les articles ayant plusieurs infobox. Et vu le nombre de paramètres de la plupart des infobox, ce paramètre se retrouve de toute façon noyé au milieu d'un tas d'autres paramètres optionnels. Donc l'impact est moindre. Le mieux serait surtout que phab:T69659 avance (demandé en 2013 déjà).

Pour le risque qu'un paramètre non-documenté volontairement soit ajouté dans les données TD par un contributeur de bonne foi existe, mais pour avoir un très grand nombre de modèles et pages de doc correspondantes en suivi, c'est très rare. Ça m'arrive que quelques fois par année de devoir repasser le supprimer. Le problème est plutôt qu'il est inséré avec tout le tas de paramètres quand un contributeur clique sur le bouton pour importer tous les paramètres d'un modèle. Ce qui se produit généralement quand le modèle n'était pas documenté.

---

Pour les paramètres ayant des relations de dépendance (comme taille logo pour logo) ou mutuellement exclusifs (X ou Y, mais pas les deux), il n'y a aucune solution en l'état (phab:T52407, demandé en 2013 déjà).

On a un nombre incalculable de bugs et demande de fonctionnalités sur Phabricator, mais très peu sont implémentés (TemplateData n'a bénéficié que de très peu d'évolutions ces dernières années). Alors que certaines fonctionnalités nous faciliteraient bien la vie.

Savoir aussi que les paramètres vides ne sont maintenant plus insérés par l'EV dans le wikicode généré (sauf bien entendu si ce paramètre était déjà présent dans le wikicode avant l'édition). Donc « ajouter » un paramètre depuis l'EV sans le remplir n'est pas grave.

La pédagogie avec les utilisateurs de l'EV est très très compliquée. Et ce n'est pas à eux de s'adapter à nos problèmes de maintenance. Les nocat n'ont rien à faire dans les articles ; donc inutile de proposer ce paramètre. Comme ça le problème de la « pédagogie » envers les utilisateurs de l'EV est réglé. J'ai déjà assez d'autres problèmes de « pédagogie » et autres contraintes à prendre en compte avec eux pour ne pas en rajouter.

C'est moins point de vue sur le sujet, après c'est toujours bien d'avoir d'en discuter.

--Tractopelle-jaune (discuter) 27 mars 2022 à 19:11 (CEST)

Je ne vois pas mon erreur...

...ni ChatGPT, dans la syntaxe de documentation suivante. Quelqu'un peut m'aider ?

<templatedata>
{"params": {
		"langue": {
			"label": "Langue",
			"description": "Code langue de la chaîne",
			"type": "string",
		      },
		"text": {
			"label": "Text",
			"description": "Texte en français (souvent abrégé ou accordé différemment) à afficher sur le lien. Si omis, affiche le code de la chaîne",
			"type": "content",
              },
         "handle": {
			"label": "Handle",
			"description": "paramètre à utiliser s'il y a un @ dans les caractères",
			"type": "string",
               },
         "user": {
			"label": "user",
			"description": "à compléter",
			"type": "string",
               }
             }
}
</templatedata>

- Simon Villeneuve 27 janvier 2023 à 18:20 (CET)

Remarque très naïve (par comparaison avec les exemples de syntaxe templatedata). N'y aurait-il pas des virgules en trop à la fin des liste d'attributs, avant l'accolade fermante?

<templatedata>
{"params": {
		"langue": {
			"label": "Langue",
			"description": "Code langue de la chaîne",
			"type": "string",
		      },

ici après "string"? HB (discuter) 27 janvier 2023 à 18:48 (CET)

Bingo, c'est ça ! Merci !
ChatGPT me l'avait dit, mais quand je lui ai dit que je ne voyais pas où les virgules étaient inadéquates, ils a mis 40 secondes à réfléchir, puis m'a dit qu'il n'y avait finalement pas d'erreur. - Simon Villeneuve 27 janvier 2023 à 21:00 (CET)

Paramètres répétés

Dans certains modèles, un paramètre (ou un groupe de paramètres) peut être répété. Par exemple, auteurn (et prénomn nomn) dans {{lien web}}.

Faut-il absolument répéter, a minima, des inherits, comme "auteur2":{"inherits":"auteur1"} , "auteur3":{"inherits":"auteur1"}, etc., ou y a-t-il une syntaxe particulière pour préciser que auteur1 peut être répété. Je ne la trouve pas dans la doc.

Je n'ai pas particulièrement l'intention de passer du temps à corriger les TemplateData de {{lien web}} mais plutôt d'en créer pour les modèles lua où il n'y a pas de TemplateData.

Cdt,

LeFit (discuter) 31 janvier 2024 à 13:30 (CET)