Help:TemplateData/fr

 est un moyen de stocker des informations au sujet d’un modèle wikitext et de ses paramètres, de manière à ce que l’éditeur visuel puisse les récupérer et les afficher dans son éditeur de modèles, rendant ainsi plus facile l’édition de pages qui utilisent ce modèle.

L’extension TemplateData est installée sur tous les wikis WMF. Si vous avez votre propre wiki, vous devrez installer Extension:TemplateData.

La syntaxe TemplateData permet aux utilisateurs d'écrire de petits morceaux de données structurées dans une page de modèle, ou à inclure dans cette page de modèle (comme par exemple sur un modèles de page de documentation). Une fois qu'un modèle a ces données structurées, il peut être affiché correctement dans l'Éditeur Visuel. Bien que cela puisse sembler compliqué, c'est en fait très simple.

TemplateData editor
Il y a un outil intégré pour modifier les TemplateData de manière plus simple.

To use the TemplateData editor, go to the template's page (or its documentation subpage) and press the "Edit" button. That will give you a button that says "", just above the open editing window:

Click this button to enter the GUI tool for editing TemplateData.

The editor allows you to add template parameters and to set the most common attributes. If the page you edited already contains a block of TemplateData, then the information already documented will automatically be shown when you open the correct page in the TemplateData editor. In the first box, you can add or update a short description of the template in plain text. After that, you can use the "Add suggested parameter(s)" and "Add parameter" buttons to document the names and attributes of the parameters that the template uses.

If the template documentation is in a subpage, the "Add suggested parameter(s)" button will only appear on the template page. A solution is to edit the template page, click on the "Add suggested parameter(s)" in the TemplateData editor and then copy-and-paste the TemplateData content (between the and tags) in the documentation subpage.

If the template page is protected, you can copy-and-paste the template code in the subpage, use the "Add suggested parameter(s)" button there, copy the TemplateData content, edit back the subpage to get rid of the template code and then paste the TemplateData content. To know where to paste the TemplateData content inside the subpage, you can edit TemplateData without adding anything; you can then replace the and tags and their content by pasting over them.

Vous pouvez lister le nom du paramètre, tous ses alias, l’intitulé et la description qui sera affichée pour les utilisateurs. Vous pouvez aussi proposer un exemple sur la façon d’utiliser le paramètre. Le seul champ obligatoire est le Nom (le premier champ de chaque ligne), qui est l’endroit où vous inscrivez le nom exact du paramètre, avec la casse correcte. Dans le menu déroulant « Type », vous pouvez choisir le type du contenu que le paramètre doit recevoir, tel qu’une chaîne (pour les messages en texte seul), une page (pour les liens vers d’autres pages), ou une date. Si le modèle produit une erreur lorsque ce paramètre n’est pas rempli, marquez ce paramètre comme « Obligatoire ». Si le paramètre est souvent utilisé ou recommandé, marquez-le comme « Suggéré ». Le bouton « Supprimer le paramètre » retire du TemplateData l’entrée concernant le paramètre.



Lorsque vous avez fini de documenter chacun des paramètres, cliquez sur « Appliquer » pour insérer le TemplateData pré-formaté dans le champ d’édition. Vous devez ensuite encore enregistrer la page en utilisant le bouton classique « Enregistrer » sous le champ d’édition.

Attention : l’éditeur TemplateData placera le TemplateData soit sur la page du modèle, soit sur sa sous-page de documentation. Vous déterminez l’endroit où le TemplateData sera ajouté en ouvrant (en éditant) la page où vous voulez que le TemplateData soit. Toutefois, si plusieurs blocs de TemplateData sont placés sur un même modèle, seul un de ces blocs de TemplateData sera utilisé. S’il y a déjà un TemplateData sur une page, alors vous devez éditer la page où le TemplateData a été ajouté précédemment pour éviter de créer accidentellement plusieurs blocs de TemplateData.

Limitations et questions

 * Fonctionnalités manquantes — TemplateData est vraiment un exemple d’outil qui a été créé avec de nouvelles fonctionnalités, dans l’espoir que les utilisateurs aideraient à guider le développement de fonctionnalités telles qu’ils le désirent. Si vous voulez demander de nouvelles fonctionnalités pour TemplateData, faites-le-nous savoir.
 * Retards pour l'affichage dans les modèles — Après que TemplateData ait été ajouté à un modèle, les métadonnées devraient être visibles immédiatement lorsque le modèle est ouvert dans l’éditeur visuel. Toutefois, il est possible que cela prenne plusieurs heures avant que les métadonnées ne soient affichées. Vous pouvez forcer la mise à jour en faisant une modification vide sur la page du modèle lui-même (pas la sous-page de documentation). Pour faire une modification vide, ouvrez la page du modèle en édition et enregistrez la page sans faire du tout de changements ni ajouter de résumé de modification.
 * Problèmes en cours — Une liste des bogues actuels et des demandes de fonctionnalités est disponible sur le gestionnaire de bugs Wikimedia.

Où est TemplateData
TemplateData doit être sur la page qu'il décrit, ou être inclus dedans. A l'intérieur d'un modèle, il doit typiquement être entouré de balises. Concernant le rendu d'une page normale, il affiche la documentation générée automatiquement comme indiqué dans #Example.

Structure des TemplateData
La structure des TemplateData est basée sur le standard JSON. Notez que toutes les descriptions dans un TemplateData doivent être en texte seul (pas de wikitexte, pas de liens, etc.).

La première chose à faire est de taper une paire de balises, n’importe où sur la sous-page de documentation, comme ceci :

Cela fait savoir au logiciel que tout ce qu’il y a entre ces deux balises sera du TemplateData, et devra être référencé lorsque le modèle sera utilisé.

Exemple
Les descriptions dans les TemplateData suivent un schéma standard ; supposons que vous ayez un modèle appelé « Commons » pour créer un lien vers une catégorie de Commons à propos d’un sujet. Il prend un paramètre obligatoire : le nom de la catégorie sur Commons. Le TemplateData ressemblerait à quelque chose comme ça :

Ceci apparaîtrait, dans le modèle, ainsi :

{   "description": "Un modèle pour créer un lien vers une catégorie de Commons à propos d’un article", "params": { "1": {           "label": "Catégorie de Commons", "description": "La catégorie de Commons vers laquelle vous voulez créer un lien.", "default": "Category:CommonsRoot", "type": "string", "required": true }   } }

Description et paramètres
Une fois que vous avez fini, cliquez sur « Enregistrer ». Si vous avez fait des erreurs, vous ne pourrez pas enregistrer (ce qui peut être troublant, mais garantit que vous ne pouvez rien casser). Si vous avez des erreurs, vous pouvez expliquer sur la page des retours ce que vous essayez de faire, et nous serons heureux de vous aider.

Notez que chaque information est entourée par des guillemets droits (") (sauf pour  et  ), et séparée de la suivante par une virgule (à moins que ce soit la dernière).

Alias de paramètres
Quelques modèles permettent qu’un même paramètre ait plusieurs noms différents.

Par exemple,  peut être écrit comme   ou.

Pour ajouter cette information dans TemplateData, vous devez simplement ajouter les alias dans les informations du paramètre :

Valeur automatique
Vous pouvez spécifier une « valeur automatique » pour un paramètre. Lorsque les utilisateurs ajoutent le modèle sur une page, cette valeur sera ajoutée automatiquement. Par exemple, plusieurs modèles pour l’entretien des pages ont besoin que la date soit ajoutée ; si vous spécifiez une valeur automatique pour le paramètre date du modèle, alors la date sera complétée automatiquement.

Pour ajouter cette information dans TemplateData, ajoutez simplement la valeur automatique dans les informations du paramètre. Il est probable que vous ayez besoin d’utiliser  pour faire que les valeurs soient permanentes :

Paramètres multiples
Si vous avez plusieurs paramètres, répétez simplement chaque section (en commençant par l'étiquette "1") et remplissez comme vous le désirez. Notez que si un modèle a plusieurs paramètres, vous devez les séparer par une virgule dans le TemplateData, comme ceci :

Paramètres similaires
Lorsqu’un modèle a plusieurs paramètres, il est possible que certains d’entre eux soient du même type. Dans ce cas, vous n’avez besoin de remplir toutes les propriétés que pour le premier, et les autres peuvent « hériter » des propriétés de celui-ci.

Structure vierge
Vous pouvez copier la structure vierge ci-dessous pour ajouter un nouveau TemplateData à un modèle. Seules les étiquettes les plus courantes sont présentes.

Autres outils

 * TemplateDataEditor: Un script utilisateur facilite le processus d’ajout de TemplateData. Il existe actuellement en français (contient des traductions en anglais, italien, japonais et coréen) et peut facilement être traduit dans d’autres langues.
 * TemplateData Wizard: Un outil qui génère un TemplateData grâce à une interface interactive.
 * Skeleton TemplateData generator: Un outil qui lit le wikicode source d’un modèle, essaye de trouver tous les paramètres utilisés et donne un squelette avec les paramètres listés.
 * JSONLint: Un outil qui vous permet de valider un JSON écrit à la main pour trouver les erreurs dans la syntaxe.
 * Liste de tous les modèles avec TemplateData sur ce wiki
 * Sur la version allemande de Wikipédia, avec le modèle TemplateData, les données du modèle sont affichées dans une boîte de dialogue, et le modèle est ajouté dans une catégorie des modèles avec TemplateData.