Aide:TemplateData

From mediawiki.org
This page is a translated version of the page Help:TemplateData and the translation is 83% complete.
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur les pages d’aide concernant le domaine public.
PD

TemplateData est une extension qui stocke les informations et les paramètres associés à un modèle wikitext template et les met à la disposition d'une interface d'édition qui peut les récupérer et les présenter dans un éditeur de modèles -- tout cela aide les utilisateurs à ajouter et à modifier des modèles sur les pages.

Depuis avril 2019 la fonctionnalité TemplateData fait partie de l'expérience utilisateur par défaut pour tous les utilisateurs de tous les wikis Wikimedia lorsqu'ils ajoutent un modèle, même pour les utilisateurs non enregistrés. A la fois l'Editeur de source et l'Editeur Visuel l'intègrent à leur manière, comme le font beaucoup de scripts, d'outils et de gadgets. Si vous souhaitez avoir cette fonctionnalité sur votre propre wiki, installez Extension:TemplateData .

Ajouter TemplateData à un modèle pour utiliser cette extension consiste à insérer simplement un petit bloc JSON (expliqué ci-dessous) dans la page de documentation du modèle. Vous pouvez le faire manuellement ou avec l'éditeur TemplateData, une interface utilisateur graphique à laquelle vous pouvez accéder sur les pages « Modifier »/« Modifier le wikicode » d'un modèle sur les wikis avec l'extension TemplateData installée. Les données JSON contiennent une liste de paramètres avec des informations sur chaque paramètre du modèle et sur le modèle lui-même (voir plus bas pour les détails).

Les modèles qui ont des TemplateData afficheront ces informations dans l'interface utilisateur quand un utilisateur ajoute le modèle. Dans certains cas, cela changera le comportement de l'éditeur lors de la modification ou l'insertion du modèle, facilitant grandement le parcours des étapes nécessaires pour ajouter ce modèle.

Historique

À l'origine, TemplateData a été développé début 2013 pour VisualEditor qui était en phase de test MediaWiki à l'époque. VisualEditor est l'interface d'édition principale pour les wikis Wikimedia, et TemplateData lui a permis d'avoir une interface plus utilisable pour l'ajout de modèles. Il a été officiellement supporté par VisualEditor immédiatement. Alors que VisualEditor était déployé sur les différents wikis Wikimedia majeurs en tant que fonctionnalité par défaut de 2013 à 2016, TemplateData a aussi été embarqué.

En décembre 2016, l'interface VisualEditor a été rendue disponible pour l'édition du code source en tant que fonctionnalité bêta. Cela a été appelé Éditeur de wikicode 2017 . Cela a amené les fonctionnalités de TemplateData à l'édition source pour la première fois.

En mars 2018, Sam Wilson a développé TemplateWizard , une extension graphique de l'éditeur de modèle pour l'éditeur de source par défaut de Wikimedia, WikiEditor (aussi connu comme l'éditeur wikitexte 2010), conçu pour faciliter l'ajout de modèles en utilisant les informations de TemplateData. En avril 2019, TemplateWizard est devenu une fonctionnalité par défaut de l'éditeur de wikitext 2010 sur tous les wikis Wikimedia. Cela signifiait que TemplateData faisait désormais partie par défaut de l'éditeur visuel et de l'éditeur source sur les wikis Wikimedia.

Ajouter ou modifier TemplateData

Pour ajouter ou modifier les TemplateData, allez sur la page du modèle "/Modèle:nom du modèle".

Vérification de l'état actuel

Avant d'ajouter ou modifier des TemplateData, vérifiez si le modèle a une sous-page de documentation. Ensuite vérifiez si le modèle contient déjà des TemplateData, et dans ce cas si elles sont placées dans la page du modèle ou de sa sous-page de documentation.

Assurez-vous de vérifier qu'une sous-page existe. Si vous ajoutez des TemplateData dans la page principale du modèle alors qu'il existe une sous-page avec des TemplateData, les TemplateData de la page principale seront prioritaires sur celles de la sous-page.

Sous-page de documentation

Concernant les modèles et sur la plupart des wikis Wikimedia, il y a deux techniques pour enregistrer le manuel d'utilisation et les autres données comme les catégories, qui ne doivent pas être incluses dans la partie exécutable du modèle :

  • la plupart des modèles gardent le mode d'emploi et les autres données n'appartenant pas au modèle lui-même dans une sous-page de documentation "/Modèle:Nom du modèle/Documentation". Alors le modèle {{Documentation}} transclut la sous-page /Documentation dans la page du modèle. Cela rend le code source nettement plus lisible.
    • Vous pouvez rapidement identifier si un modèle a une page /Documentation en vérifiant si le titre de la « Test Template Info-Icon - Version (2).svg Documentation du modèle » (ou équivalent) a des liens comme « [voir] [modifier] [historique] [purger] ».
  • quelques pages de modèles placent directement ces informations dans la page d'accueil du modèle. Dans ce cas, il s'agit du contenu qui suit {{Documentation|content= et qui est compris entre les balises ‎<noinclude>.

Sur des wikis différents, tout ceci peut apparaître différemment. Il est rare que la page d'accueil du modèle contienne encore la documentation même si vous avez tout coché; Cela arrive quand un utilisateur a ajouté une page /doc avec un titre personnalisé entre « {{Documentation| » et « |content= » et a ensuite ajouté du contenu après « |content= ».

Vous pouvez aussi chercher une note au bas de la page similaire à "La documentation ci-dessus est issue de la sous-page de documentation du modèle" (ou équivalent).

Modèles sans sous-page de documentation

Si un modèle n'a pas de sous-page de documentation, créez-la et placez-y la documentation du modèle (ou son point d'entrée). Vous pourrez ensuite ajouter TemplateData à la sous-page de documentation.

Créer la sous page de documentation et déplacer le contenu de la documentation
Sur de nombreux wikis Wikimedia, vous ne pouvez créer une page que si vous êtes un utilisateur enregistré depuis un certain nombre de jours et si vous avez effectué un nombre minimum de modifications.

Pour créer la sous-page de documentation, cliquez sur « Modifier  » / «  Modifier le wikicode  » de la page d'accueil du modèle ; cherchez les balises ‎<noinclude> et leur contenu (habituellement en bas).

Cela devrait se présenter ainsi :

<noinclude>
{{Documentation|content=
== Usage ==

Information about usage.

== More example headings ==

More example contents

[[Category:Example category]]
[[Category:Example category 2]]
}}
</noinclude>

Vous pouvez également constater qu'il y a déjà des TemplateData. Si c'est le cas, cela ressemblera à :

<noinclude>
{{Documentation|content=
...
<templatedata>
{
    "description": "",
    "params": {
        "1": {
            "label": "Example parameter",
            "description": "Example parameter description",
            "type": "string"
        }
    }
}
</templatedata>
</noinclude>

Selectionnez tout ce qui suit « |content= » et jusqu'avant « ‎</noinclude> » puis copiez-le dans votre presse papier ou enregistrez-le dans un document temporaire. Supprimez « |content= », en ne laissant que :

<noinclude>
{{Documentation}}
</noinclude>

Enregistrez alors la page du modèle.

Maintenant, pour créer la nouvelle sous-page, regardez dans la barre d'adresse de votre navigateur et ajoutez /doc à la fin de l'URL. Cliquez sur ↵ Enter, puis choisissez l'option pour créer une nouvelle page.

Si ce wiki possède un modèle de notification {{Documentation subpage}}, ajoutez-le en haut de la nouvelle page. Vous souhaitez peut-être également ajouter d'autres modèles, tels qu'un lien {{Purge button}} ou {{Purge}} (s'il est pris en charge par le wiki en question). Voir m:Help:Template documentation pour d'autres informations.

Insérez le texte que vous avez coupé ou enregistré du texte précédent (sous la notice du modèle, si c'est le cas).

Encadrez les catégories avec des balises ‎<includeonly> afin qu'elles ne s'appliquent que sur la page d'accueil du modèle :

<includeonly>
[[Category:Example category]]
[[Category:Example category 2]]
</includeonly>

Beaucoup de wikis possèdent un modèle {{Sandbox other}}. Utilisez ce modèle ici s'il est possible que le modèle que vous modifiez existe dans une version bac à sable (située dans Template:NomDuModèle/sandbox) afin d'empêcher les catégories de s'appliquer à la page du bac à sable :

<includeonly>{{sandbox other||
[[Category:Example category]]
[[Category:Example category 2]]
}}</includeonly>

Publiez enfin la page.

Vous pouvez maintenant ajouter et modifier les TemplateData de la sous-page de documentation en utilisant les règles décrites ici.

Ajouter ou modifier les TemplateData sur la page principale du modèle

Si vous ne pouvez pas créer la page /doc, vous pouvez ajouter et modifier les TemplateData sur la page d'accueil du modèle en suivant les instructions décrites ici.

Si un modèle possède une sous-page de documentation, vérifiez à la fois la page d'accueil et la sous-page de documentation quant à la présence de TemplateData (balise ‎<templatedata> suivie d'un tableau encadré d'accolades : {}).

Par ailleurs l'extension TemplateData peut faire ce contrôle pour vous. Cliquez sur « Modifier » ou «  Modifier le wikicode  » sur chaque page. Si le modèle possède déja des TemplateData sur l'une des pages, vous verrez une notice jaune en haut de la page disant soit :

Veuillez noter : il y a déjà une section TemplateData sur la page liée « Modèle:'''NomDuModèle'''/doc ».

ou

Veuillez noter : il y a déjà une section TemplateData sur la page liée « Modèle:'''NomDuModèle''' ».

Si le modèle a des TemplateData sur la sous page de documentation

Si le modèle possède des TemplateData sur sa page de documentation, c'est celle-ci que vous devrez modifier. Pour faire cela cliquez sur « [edit]  » qui se trouve après le titre « Test Template Info-Icon - Version (2).svg Template documentation » (ou équivalent) ou si vous êtes déjà sur la page /doc, cliquez sur « Modifier » ou « Modifier le wikicode » en haut. Suivez les règles suivantes pour ajouter ou modifier les TemplateData.

Si le modèle possède des TemplateData sur sa page d'accueil

Si le modèle possède des TemplateData sur sa page d'accueil, vous avez encore une fois deux options :

  • Vous pouvez aller sur sa page de documentation. C'est l'option recommandée.
  • Ou vous pouvez les modifier sur la page d'accueil du modèle.

Déplacer les TemplateData vers la sous page de documentation

Pour faire cela cliquez sur « ‎<noinclude> » / « Modifier » de la page d'accueil du modèle et cherchez les balises ‎<templatedata> à l'intérieur des balises ‎<noinclude> . Ce qui devrait ressembler à quelque chose comme :

<noinclude>
{{Documentation}}
<templatedata>
{
    "description": "",
    "params": {
        "1": {
            "label": "Exemple de paramètre",
            "description": "Exemple de description de paramètre",
            "type": "string"
        }
    }
}
</templatedata>
</noinclude>

Retirez du code simplement les balises ‎<templatedata> avec leur contenu, et enregistrez la page.

Ensuite, modifiez la sous-page de la documentation en cliquant sur [edit] qui se trouve après le titre Test Template Info-Icon - Version (2).svg Template documentation (ou équivalent).

Saisissez un titre, comme « TemplateData  » puis collez les TemplateData en-dessous.

Vous pouvez maintenant mettre à jour les TemplateData en vous appuyant sur les règles décrites ici.

Éditer TemplateData sur la page principale du modèle

Si vous ne souhaitez pas déplacer les TemplateData vers la page /doc , vous pouvez les modifer sur la page principale du modèle. Voir les méthodes sur la manière de modifier les TemplateData.

Si le modèle n'a pas encore de TemplateData mais a une sous page de documentation

Si le modèle ne possède pas encore de TemplateData, vous devez les ajouter sur la sous-page de documentation.

Pour faire cela cliquez sur « [edit]  » qui se trouve après le titre « Test Template Info-Icon - Version (2).svg Template documentation » (ou équivalent) ou si vous êtes déjà sur la page /doc, cliquez sur Modifier ou Modifier le wikicode en haut. Entrez un titre tel que TemplateData, puis ajoutez-les sous ce titre. Cette section explique comment ajouter les TemplateData.

Méthodes

Méthode de l'éditeur TemplateData

Ceci est une manière facile pour ajouter ou modifier les TemplateData, recommandée pour les utilisateurs moins expérimentés.

L'éditeur TemplateData est une interface graphique pour ajouter et modifier TemplateData. Il fait partie de l'extension TemplateData, disponible sur toutes les pages des modèles (ou de la sous-page de documentation) en cliquant sur « Modifier » ou « Modifier le wikicode » .

Après avoir cliqué sur « Modifier » ou « Modifier le wikicode », un bouton apparaît au-dessus de la zone de modification et le titre de la page devient « Gérer TemplateData ».

Manage template documentation button for TemplateData 2014.png

Cliquer sur ce bouton permet d'entrer dans l'éditeur TemplateData. Si la page que vous éditez contient une section TemplateData, elle sera automatiquement affichée ici.

Une capture d'écran de l'outil d'édition TemplateData

Fonctionnalités de la fenêtre ci-dessus :

  • L'élément supérieur sélectionne la langue du texte de l'interface. Cela vous permet d'entrer le contenu textuel dans plusieurs langues, affiché aux utilisateurs en fonction des paramètres de leurs Préférences et non basé sur la langue du wiki; des wikis différents possèdent des bases de données de modèles complètement différentes. S'il n'existe pas de TemplateData par langue, l'interface ne propose à l'utilisateur que la langue propre au wiki mais les utilisateurs peuvent cliquer sur « Ajouter des traductions  » pour ajouter plus d'entrées. Le code de langue est affiché entre crochets à côté des paramètres sur lesquels il peut être appliqué, tels que les descriptions et les étiquettes.
  • L'élément suivant est la description du modèle. Il s'agit de la description globale; elle est affichée aux utilisateurs à différents endroits des éditeurs de modèle lors de l'ajout d'un modèle. Ce paramètre et ses actions sont détaillés ici.
  • Le troisième élément contrôle la mise en forme du wikicode du modèle. Ce paramètre détermine la manière dont le wikicode est affiché lorsque l'utilisateur clique sur « Appliquer » ; les deux possibilités principales sont "inline" (sur une même ligne) et "block" (sur des lignes séparées). Ce paramètre et ses actions sont détaillés ici.
Si l'utilisateur choisit « Personnalisation », il peut entrer le wikicode sous « Chaîne de format personnalisé » en suivant les règles décrites ici, afin de créer un affichage personnalisé pour le modèle quand l'utilisateur clique sur « Appliquer ».
  • Le quatrième élément configure les paramètres d'un modèle. Ce champ les affiche sous forme de liste s'ils ont déja été définis dans TemplateData. Si le code source du modèle spécifie des paramètres qui n'ont pas de TemplateData, un bouton « Ajouter 2 paramètres suggérés » apparait. L'éditeur extrait ces suggestions du code source du modèle en cherchant {{{parametername}}} ou {{{parametername|}}}. En cliquant sur « Ajouter 2 paramètres suggérés » vous ajouterez ces paramètres en utilisant leur nom tel qu'il est déclaré dans le code source. Une information en vert apparait aussi en haut, comme par exemple « 2 nouveaux paramètres ont été importés : nom des paramètres. » .
  • En bas de la fenêtre le bouton « Ajouter un paramètre » vous permet d'ajouter manuellement un paramètre avec son nom personnalisé.

Continuez jusqu'à l'étape suivante en cliquant sur n'importe quel paramètre de la liste. Ceci vous permet de modifier les informations associées à ce paramètre.

Capture d'écran de l'éditeur TemplateData montrant l'ajout d'un second paramètre

Toutes ces fonctions et leurs actions sont décrites dans cette section.

  • L'éditeur des TemplateData ne vous permet pas d'assigner un espace « Nom » à un paramètre. Les paramètres de TemplateData qui quelque fois reçoivent une chaîne vide comme nom ne créent pas de problème dans l'éditeur de wikicode 2010 avec TemplateWizard, et ni l'Editeur visuel ni l'éditeur de wikicode 2017 ne les afficheront. C'est le seul champ obligatoire de l'éditeur des TemplateData.
  • Clicking "Supprimer le paramètre" will delete the parameter and all its information from the TemplateData. You can't retrieve or undo this in the TemplateData unless you click "X" afterwards. You can undo any changes made after clicking "Appliquer" by hitting Ctrl+Z.
  • La sortie de l'éditeur des TemplateData après avoir réalisé les modifications vous demande de confirmer l'annulation de vos modifications.

Lorsque vous avez terminé, cliquez sur « Supprimer le paramètre ». Ceci va automatiquement insérer les TemplateData en bas de la page, avant la balise ‎</noinclude>; ou, si elles sont déjà présentes, elles seront mises à jour avec les nouvelles informations sans en modifier la position. Le texte des TemplateData sera également sélectionné quand vous cliquerez sur « Supprimer le paramètre  ».

L'éditeur des TemplateData crée un paramètre "paramOrder" au bas de TemplateData (ou le met à jour s'il existe déjà). "paramOrder" contient les paramètres actuels de TemplateData dans l'ordre affiché par leur éditeur. Vous pouvez changer "paramOrder" en faisant glisser les paramètres vers le haut ou vers le bas dans l'éditeur des TemplateData en utilisant les trois barres horizontales de gauche. "paramOrder" et ses conséquences sont décrites ici.

Puis, cliquez sur « Enregistrer » pour enregistrer votre version de la page.

Méthode manuelle

Vous pouvez aussi ajouter ou modifier manuellement les TemplateData. TemplateData est écrit en JSON, mais vous n'avez pas besoin d'apprendre JSON pour savoir comment créer TemplateData. TemplateData suit quelques règles très simples et n'accepte qu'une petite douzaine de paramètres prédéfinis avec leur valeurs, typiquement en suivant un format "parameter": "value".

Ajouter TemplateData manuellement

Cas :

  • Si vous ajoutez les TemplateData à la sous-page de documentation d'un modèle (ce qui est recommandé), vous pouvez les ajouter n'importe où sur la page ; vérifiez si la Wikipedia de votre langue a un endroit préféré pour ces données. Par exemple, pour la Wikipedia anglophone, les TemplateData se trouvent typiquement en bas de la page de documentation ; par contre, sur la Wikipedia allemande, elles sont en haut.
  • Si vous ajoutez des TemplateData à la page d'accueil d'un modèle, ce qui (n'est pas recommandé; voir les vérifications initiales ici), vous devez vous assurer qu'elles sont encadrées avec des balises ‎<noinclude>...‎</noinclude>.

Cliquez sur « Modifier» ou « Modifier le wikicode » en fonction de la page, puis allez à l'endroit de la page où vous voulez ajouter les TemplateData et placez le titre : TemplateData.

Plusieurs wikis ont un modèle {{TemplateData header}} qui ajoute une courte notice concernant les TemplateData. Si c'est le cas avec votre wiki, ajoutez-la après le titre.

Pour commencer à ajouter les TemplateData, entrez une balise ‎<templatedata> ouvrante et fermante et une paire d'accolades sur de nouvelles lignes séparées par une ligne vide :

<templatedata>
{

}
</templatedata>

Next, add an indent on the empty line between the two curly brackets, and start adding parameters. Details for the parameters can be found at #TemplateData parameters. Most are optional; some are highly recommended.

Les paramètres peuvent être dans un ordre quelconque, mais suivent l'ordre qui se rapproche le mieux de la documentation des TemplateData rendant le contenu plus facile à utiliser pour les éditeurs :

<templatedata>
{
    "description": "",
    "format": "",
    "params": {
        "parameter1": {
            "aliases": ["",""]
            "label": "",
            "description": "",
            "type": ""
        }
    },
    "paramOrder": [
    	""
    ]
}
</templatedata>

Assurez-vous que les paramètres, par exemple dans l'objet "params", restent à l'intérieur de cet objet, sinon vous déclencherez une erreur "Propriété « properlyname » non attendue." lorsque vous tenterez d'enregistrer.

Exemple

Voici quelques exemples de TemplateData pour une réorganisation hypothétique d'un modèle. Un tel modèle est censé afficher une notice et placer la page dans une catégorie datée basée sur le mois et l'année de la saisie. Il est également possible que la notice contienne un lien vers une section de la page de discussion. Les TemplateData vont donc ressembler à ceci :

<templatedata>
{
	"description": "Utilisez ce modèle pour signaler qu'un article doit être réorganisé.",
	"format": "inline",
	"params": {
		"date": {
			"label": "Mois et année",
			"description": "Mois et année au cours de laquelle le modèle a été ajouté",
			"type": "string",
			"autovalue": "{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}",
			"example": "janvier 2013",
			"suggested": true
		},
		"reason": {
			"aliases": ["1"],
			"label": "Motif",
			"description": "Motif pour lequel l'article doit être réorganisé",
			"type": "string"
		},
		"talk": {
			"aliases": ["section de discussion"],
			"label": "Section de la page de discussion",
			"description": "Section de la page de discussion contenant la discussion correspondante",
			"type": "string"
		}
	},
	"paramOrder": [
		"date",
		"reason",
        "talk"
	]
}
</templatedata>

La documentation correspondante de TemplateData s'affiche ainsi :

Utilisez ce modèle pour signaler qu'un article doit être réorganisé.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
mois et annéedate

Mois et année au cours de laquelle le modèle a été ajouté

Example
janvier 2013
Auto value
{{SUBST:CURRENTMONTHNAME}} {{SUBST:CURRENTYEAR}}
Stringsuggested
Motifmotif 1

Motif pour lequel l'article doit être réorganisé

Stringoptional
Section de la page de discussiondiscussion section de discussion

Section de la page de discussion contenant la discussion correspondante

Stringoptional

Paramètres de TemplateData

Tous les paramètres TemplateData disponibles sont énumérés ci-dessous avec une description et un exemple. Ils sont également répertoriés avec plus de détails techniques à Extension:TemplateData#Format.

  • Ces informations sont à jour en novembre 2021 et peuvent changer si de nouveaux paramètres sont ajoutés ou si les interfaces d'édition des modèles sont mises à jour pour prendre en charge les paramètres existants ou traiter certains paramètres différemment.
  • La syntaxe wiki ne marchera pas dans les descriptions ou les étiquettes. Ce sont purement des chaînes de texte brut.
  • New lines ("\n") in descriptions, labels, examples or defaults will not show in any of the main editors (TemplateWizard, VisualEditor or the 2017 wikitext editor), even though they show in the auto-generated TemplateData documentation. Ils sont remplacés par la chaîne vide dans les formulaires de saisie et ailleurs par un espace.
Paramètre Description Exemple
description

Le paramètre "description" décrit ce que le modèle fait. C'est optionnel mais fortement recommandé.

Effets

Sur la page de documentation du modèle, la description s'affichera en texte brut sous la section "Données du modèle [nom du modèle]".

Dans chaque éditeur principal (VisualEditor , le Éditeur de wikicode 2017 et le WikiEditor avec l'assistant de modèles), la description s'affiche dans deux instances principales :

  • Sous le nom du modèle dans chaque suggestion de recherche lorsqu'un utilisateur cherche un modèle
  • sous le nom du modèle dans l'éditeur de modèles, lorsque l'on ajoute des valeurs aux paramètres du modèle

In the VisualEditor and 2017 wikitext editor, the description gets truncated to about 50 characters under each search suggestion, followed by a "...", but the whole description shows in the main template editor window. Les deux apparaissent en texte grisé.

Dans la fenêtre principale de l'éditeur de modèle, les descriptions qui dépassent quatre lignes (soit environ 540 caractères) sont présentées en texte noir et avec un ascenseur séparé.

Si non spécifié

Si le paramètre de description n'existe pas ou qu'il n'est pas spécifié, le texte « Aucune description.  » sera affiché dans la documentation des TemplateData sous le sous-titre « Template data pour [NomDuModèle]  ». Et aussi :

  • in VisualEditor and the 2017 wikitext editor, it will behave the same as a template that does not have TemplateData; instead of a description, the following text will display:
« Le modèle « Template:NomDuModèle » n'a pas encore de description, mais la page du modèle peut contenir des informations. »
  • dans l'éditeur de wikicode 2010 avec le TemplateWizard, le texte suivant s'affiche à l'endroit de la description (sauf pour les suggestions de recherche) :
« Aucune description n’existe pour ce modèle. »
C'est différent des deux endroits standards prévus pour les descriptions dans le cas où les TemplateData sont absentes :
  • « Parce que les TemplateData sont absentes, les paramètres de ce modèle ont été générés automatiquement. Notez-bien qu'ils peuvent ne pas être à jour. »
  • « Aucun paramètre ne peut être déterminé pour ce modèle car il n'existe pas de documentation concernant les TemplateData. Vous pouvez ajouter le modèle sans paramètre. »
"description": "Un modèle pour créer un lien vers une catégorie de Commons",
format

La suivante est "format", qui indique comment le wikitexte du modèle sera inséré. Il peut s'agir des formats standards "inline" et "block", ou l'utilisateur peut saisir un ensemble de symboles wikitext pour créer un format personnalisé ; ces symboles et quelques exemples sont listés dans la section #Formats personnalisés.

Ce paramètre n'est pas obligatoire mais il est recommandé. Le comportement par défaut lorsque ce paramètre n'existe pas est le format en mode ligne, sans notice d'information correspondante affichée dans la documentation des TemplateData sous l'entête du tableau.

Conséquences

En ligne :

Si le paramètre a la valeur "inline", le modèle affichera un avis correspondant à la préférence dans sa documentation TemplateData, sous le titre du tableau, "Paramètres du modèle" :

{{int|quotation-marks|[<translate>circles and pipes icon</translate>] {{int|templatedata-doc-format-inline}}}}

Lorsqu'il est ajouté, le modèle affiche ainsi son wikicode sur une seule ligne, sans espace entre les éléments :

{{Foo|bar=baz|qux=quux}}

Bloc :

Si le paramètre est défini sur "block", le modèle affichera l'avis de préférence suivant dans sa documentation TemplateData :

{{int|quotation-marks|[<translate>stacked blocks and pipes icon</translate>] [[int|templatedata-doc-format-block}}}}

Lorsque vous ajoutez ce modèle, il va distribuer chacun de ses paramètres sur une ligne distincte, avec un espace entre chaque élément, de la manière suivante :

{{Foo
| bar = baz
| qux = quux
}}

Formats personnalisés :

Alternatively, if the parameter is set to a custom string of wikitext, as per the rules listed at #Custom formats, the template will display the following preference notice in its TemplateData documentation:

"[<translate>cogwheel icon</translate>] {{int|templatedata-doc-format-custom}}"

Quand il sera ajouté, le modèle développera son wikicode au travers du wikicode indiqué.

"format": "inline"
params

L'objet "params" contient les informations pour chaque paramètre du modèle. Il est obligatoire, et ses paramètres peuvent être consultés dans la section #Within params.

It should contain the name of each parameter followed by a set of TemplateData sub-parameters listed in #Within a parameter's name.

S'il y a plusieurs paramètres, placez une virgule entre chaque objet paramètre, mais n'en ajoutez pas après la dernière accolade (voir exemple).

"params": {
    "parameter1": {
        ...    // informations sur le paramètre
    },      // notez la virgule ici
    "parameter2": {
        ...    // informations sur le paramètre
    },      // et ici
    "parameter3": {
        ...    // informations sur le paramètre
    }       // mais pas ici
}
paramOrder

The "paramOrder" object is an optional object that causes the parameters of a template to be displayed in a specific order when added in the template editor.

Comment l'utiliser

Add the parameter "paramOrder", followed by a colon, a space and an open square bracket, then type the name of each of the template's parameters in double quotation marks (") in the desired order, separated by commas. Terminez avec un crochet fermant (créant ainsi un tableau).

Il n'est pas utile que les paramètres soient sur des lignes séparées (on peut les écrire comme "paramOrder": ["param1","param2","param3"]), mais le fait de les écrire ainsi facilite souvent la lecture.

We recommend you place "paramOrder" after "params", as the TemplateData editor does; it isn't displayed in the TemplateData documentation but simply forces the order of the parameters. A future editor may wish to quickly look through the parameter details and edit them rather than scrolling past the "paramOrder", especially if there are a lot of parameters. If you do choose to place paramOrder somewhere besides the end of the TemplateData, end it with a comma.

You must include every parameter mentioned in the TemplateData; otherwise a "Propriété « properlyname » obligatoire non trouvée." error will show.

Si ce n'est pas défini

Without "paramOrder", the template's parameters will display in the order in which the template's source code declares them. If the source code contains objects inside objects, the parameters in outer objects will come first, followed by inner objects.

Avec les autres paramètres

Dans l'éditeur de wikicode 2010 avec TemplateWizard :

  • les paramètres "required" apparaisssent toujours en haut, quelque soit l'ordre dans "paramOrder".
  • les paramètres "suggested" apparaîtront toujours en second, au-dessus des "optional" premiers.
  • les paramètres "deprecated" n'apparaîtront pas dans cet éditeur; voir la description de "deprecated" pour plus d'informations.
  • "paramOrder" will only enforce its order within these categories (i.e., all "required" parameters will be in the order specified by "paramOrder", and all "suggested" parameters will be too, but all "suggested" parameters will appear below all "required" parameters).

In VisualEditor and the 2017 wikitext editor, "paramOrder" forces its order regardless of the status of each parameter.

"paramOrder": [
	"date",
	"reason",
	"talk"
]

Parmi les paramètres

Paramètre Description Exemple
Nom du paramètre

Le seul élément de niveau un de l'objet params est le nom d'un paramètre du modèle.

For example, in a template's source code, {{{date}}} denotes a parameter, and it should be added under "params" with the name "date".

You may also see parameters named {{{1}}} or another number (whose TemplateData name should be, for example, "1"). Parameters like this prevent a user inserting a template from having to type the parameter name and the equals sign (i.e., |value| instead of |parametername=value|). Lorsque plusieurs paramètres non nommés existent, le numéro identifie le paramètre non nommé dont il s'agit. Par exemple, dans :

{{example template|value1|value2}}

value1 est la valeur du paramètre {{{1}}}, et value2 est la valeur du paramètre {{{2}}}. Décrivez respectivement les paramètres de votre TemplateData.

Note: a user can still force the use of {{{2}}} without {{{1}}} by inserting a parameter named "2" in the template editor or typing "|2=" in wikitext. Finally, note that "aliases" creates alternatives to the parameter name which can be used interchangeably, and "label" replaces the parameter name in the user interface with the specified label (for situations in which the parameter name is not human readable or easily understood).

Comment l'utiliser

Chacun de ces objets « Nom du paramètre » doit contenir toutes les informations concernant le paramètre sous la forme de paramètre supplémentaire TemplateData. Ils sont listés dans la section suivante.

"1": {     // nom du paramètre
    ...    // les informations sur ce paramètre viennent ici
}

Avec un nom de paramètre

Paramètre Description Exemple
aliases

Le paramètre facultatif "aliases" permet à un paramètre de modèle d'avoir plusieurs noms. Vous pouvez vérifier cela en allant dans le code source du modèle et rechercher :

{{{parameter1|{{{parameter2}}}}}}

ou

{{{parameter1|{{{parameter2|}}}}}}

Cela signifie que si l'utilisateur ajoute l'un quelconque de ces paramètres avec une valeur, il réalisera la même fonction. Literally, it translates to, "Value of parameter1. If parameter1 doesn't exist or have a value: value of parameter2." Dans le second cas, cela signifie également, Si parameter2 n'existe pas ou s'il a pour valeur : aucune valeur.

To insert the "aliases" parameter, add the text "aliases" followed by a colon, a space and an open square bracket, then typing the name of each of the parameter's aliases in quotation marks, separated by commas. Fermez avec un crochet fermant pour créer un tableau.

"aliases": ["1", "talk", "talksection"],
inherits

"inherits" est un paramètre optionnel utilisé lorsqu'un paramètre doit hériter de toutes les TemplateData d'un autre paramètre. Ceci peut ensuite être réécrasé par tout paramètre spécifié comme paramètre d'héritage.

Pour utiliser ce paramètre, entrez "inherits" : suivi d'un autre nom de paramètre de modèle, tel que "talk" ou "1". Vous pouvez ensuite entrer une autre valeur particulière pour initialiser le paramètre associé si vous le souhaitez, comme "label" : "A different label". Le premier paramètre héritera de toutes les propriétés du second paramètre sauf de celle-là.

    "params": {
        "sujet1": {
            "label": "Sujet",
            "description": "Un sujet mentionné sur cette page d’homonymie",
            "type": "string"
        },
        "sujet2": {
            "inherits": "sujet1"
        },
        "sujet3": {
            "inherits": "sujet1",
            "label" : "A different label"
        }
    }
label

Ensuite, nous avons "label", dans lequel vous pouvez indiquer pour le paramètre un titre lisible par un humain, qui sera affiché dans l’éditeur de modèle. L'étiquette est affichée à chaque fois à la place du nom brut du paramètre, même si un alias est utilisé dans le wikicode. Ce paramètre est optionnel mais très recommandé.

"label": "Mois et année",
description

A l'intérieur de chaque objet nommé après un paramètre, "description" est la description du paramètre, pas du modèle dans sa globalité. Cette description apparait sous le nom du paramètre (une longue description sera tronquée et un bouton la développera optionnellement). C'est facultatif mais hautement recommandé.

"description": "Le mois et l'année à laquelle le modèle a été inséré.",
type

See the [[<tvar name=1>#Type parameter</tvar>|#Type parameter]] section.

default

Certains paramètres du modèle ont une valeur par défaut; celle-ci est utilisée à moins d'être redéfinie par l'utilisateur. L'élément "default" est optionnel, présent à titre documentaire seulement, sert à communiquer à l'utilisateur cette valeur par défaut. Il n'est pas utile que la valeur corresponde à la valeur actuelle par défaut (s'il y en a une) et n'a pas de conséquence fonctionnelle. (A ne pas confondre avec "autovalue", qui est un paramètre fonctionnel correspondant à un champ de l'utilisateur.)

Actions

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), the "default" text will show as grey text in the input box of any open parameter when it is empty, in the format "Default: default text". Additionally, it will show in plain black text in the parameter description (when the user hovers over the "i" symbol). In VisualEditor and the 2017 wikitext editor, this will be below the parameter description, below "Field is required"/"Field is deprecated", if specified (the 2010 wikitext editor doesn't show this text), and above "example", if specified ("example" does not show in the parameter description in the 2010 wikitext editor). In the 2010 wikitext editor with TemplateWizard, the "default" text shows directly after the parameter description, on the same line, following a space. Il affiche dans le même format que les autres éditeurs ("Default: texte par défaut").

Avec d'autres paramètres

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), if "default" is specified, the "example" value will not show in the input box.

"default": "Category:CommonsRoot",
autovalue

Vous pouvez assigner "autovalue" à un paramètre. When a user adds the template to a page, this value will automatically appear in the input box. For example, many cleanup templates need the date added; setting the "autovalue" for the template's date parameter to be {{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}, the month and year that the template was added will be filled in automatically.

Cette valeur peut être modifiée par l'utilisateur dans l'éditeur de modèle.

Avec d'autres paramètres

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "autovalue" overrides the visible effects of "url" in VisualEditor and the 2017 wikitext editor. Voir la description de "type" pour d'autres informations.

"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}"
example

The "example" parameter is optional and documentary only; its value contains an example that helps the template's user understand the correct way to fill in the parameter (not to be confused with "suggested"; see that entry for more information).

Conséquences

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), this property is displayed below the parameter description (and below the "default" text, if specified).

Avec d'autres paramètres

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "example" will not show in the input box if "default" is specified.

"example": "January 2013",
required

Nous avons ensuite "required" (obligatoire), qui peut être positionné à true ou false. Si elle n'est pas spécifiée, la valeur par défaut est false.

Il détermine si le remplissage du paramètre donné est obligatoire pour le modèle.

Conséquences

Cet état a plusieurs conséquences sur l'Editeur Visuel et le Éditeur de wikicode 2017  :

  • il affiche le paramètre automatiquement lorsqu'un utilisateur ajoute le modèle;
  • il affiche un astérisque noir dans la boîte de saisie, sur la droite;
  • affiche le texte gris en italique « Le champ est obligatoire. » sous la description du paramètre;
  • cela fait apparaître la boîte d'entrée en rouge si l'utilisateur clique en dehors sans entrer de valeur ;
  • si un utilisateur essaie d'insérer un modèle sans donner de valeur pour le paramètre requis, un message apparaît pour lui demander s'il est certain de l'opération. Si c'est confirmé, le paramètre sera inséré avec une valeur vide. It will not stop them from inserting the template, though, and it does not result in a visible error by itself (though templates can be programmed to display an error when a required parameter is not filled in).

In the WikiEditor with Aide:Extension:Assistant de modèle , as in the other editors, it displays the parameter automatically when a user inserts the template, but the parameter cannot be removed using this or any editor. It also does not display "Le champ est obligatoire." in the parameter description; rather, it lists the parameter on the side under "Paramètres obligatoires". Other than this, it generally behaves the same as in the other editors, except that the prompt says that the input doesn't "match the expected format".

Avec d'autres paramètres

In VisualEditor and the 2017 wikitext editor, the "deprecated" status does not override the functionality of this parameter, but in the 2010 wikitext editor with TemplateWizard it does. Voir la description de "deprecated" pour d'autres informations.

"required": true
suggested

Here we have "suggested" (suggéré), which can be set to true or false. S'il n'est pas spécifié, la valeur par défaut est false.

Use "suggested" for parameters that are not mandatory but strongly recommended for template users to provide. When filling in this parameter, a user will see this suggestion.

Conséquences

In VisualEditor and the Éditeur de wikicode 2017 , it causes the parameter to automatically show up when a user inserts a template. Si le paramètre possède une valeur automatique définie, elle figurera également dans sa boîte de saisie. Il n'a pas d'autre action et n'affiche pas de texte ni d'avertissements supplémentaires.

In the WikiEditor with TemplateWizard, it does not place the parameter in the template automatically but instead causes it to be listed on the side under "Paramètres suggérés". L'utilisateur peut ensuite cliquer sur « + » à côté du paramètre pour l'ajouter au modèle.

Avec d'autres paramètres

The "required" status overrides the functionality of this status in all main editors (VisualEditor, the 2017 wikitext editor and the 2010 wikitext editor). It also overrides the displayed "suggested" status in TemplateData documentation (it will display "required" if both "required" and "suggested" are set to true).

"suggested": true
deprecated

Enfin vient "deprecated" (usage déconseillé), qui peut être positionné à true, false ou à une chaîne de caractères décrivant ce que les utilisateurs devraient faire à la place. Si vous ne le spécifiez pas, la valeur par défaut est false.

Cet état concerne les paramètres qui ne doivent plus être utilisés, mais qui continuent d’exister pour le moment. Cela pourrait être parce que l'utilisation du modèle est en train de basculer d'un jeu de paramètres à un autre.

Conséquences

The effect of this parameter in VisualEditor and the 2017 wikitext editor is that a grey exclamation mark shows next to the parameter's label when it is inserted, and in the parameter's information tooltip, the grey, italic text "Le champ est obsolète. deprecation reason" is shown below the parameter description. Il n'impacte pas la fonction ou l'utilisation du paramètre et n'affiche pas d'avertissements supplémentaires.

Despite the fact that it can take a string, as of January 2020 none of the main editors (VisualEditor, the 2017 wikitext editor or the 2010 wikitext editor) display the contents of the string anywhere to users. Entrer une chaîne de caractères a le même effet que true.

In the 2010 wikitext editor with TemplateWizard, setting this value as true does not allow the parameter to be added or seen.

Avec les autres paramètres

If you set both this and "suggested" as true, the parameter status will show as "deprecated" in the TemplateData documentation, but in VisualEditor and the 2017 wikitext editor both functionalities will be retained; the parameter will automatically show up when a user inserts a template, but it will have the "deprecated" warnings around it.

If you set both this and "required" as true, the parameter status will show as "deprecated" in the TemplateData documentation, but in VisualEditor and the 2017 wikitext editor it will have the same functionality as only "required"; the parameter will automatically show up when a user inserts a template, and it will have the "required" warnings around it. C'est la même chose que lorsque vous initialisez "deprecated", "suggested" et "required" avec true.

Dans l'éditeur de wikicode 2010 avec TemplateWizard, "deprecated" réécrase les paramètres "required" et "suggested".

"deprecated": "Utilisez 'publicationDate' à la place."
valeurs suggérées

The parameter property suggestedvalues lets you define a list of parameter values to be shown to VisualEditor users in a dropdown for easy selection. This can be done either directly in JSON or using the TemplateData editor (no coding required). You can add suggested values to be displayed in the VisualEditor for parameters which have their type set to one of the following options (reference):

  • content
  • line
  • string
  • number
  • unknown
  • unbalanced wikitext

Other types (file, page, template, user, date, boolean, URL) are not currently supported because they have special functionalities in the VisualEditor already, such as autocomplete, which would interfere with the drop-down menu for suggested values in the VisualEditor.

Modifier le JSON des TemplateData du wikicode

Pour ajouter les valeurs suggérées à n'importe quel type de paramètre, ajoutez la nouvelle propriété "suggestedvalues" au paramètre en JSON. L'attribut “suggestedvalues” doit être une liste de chaînes de caractères.

Mise à jour des TemplateData avec l'éditeur de TemplateData

  1. Cliquez sur « Gérer TemplateData ».
  2. Cliquez sur le nom du paramètre auquel vous voulez ajouter les valeurs suggérées.
  3. If it’s not already done, set parameter type to one of the following: content, line, string, number, unknown, unbalanced wikitext. A new input field "Valeurs suggérées" will appear. If the parameter is already set to one of these types, the input field should already be visible.
  4. Type in the suggested value(s), including any spaces and special characters, and press enter to add the value(s) to the list.

Effects

Once the values have been added to TemplateData, the VisualEditor will display them in a combo box (a dropdown into which users can also enter a custom value) for the parameter types listed above. The user selects the desired value by clicking on it. If the list of values is long -- for example, a list of a country’s states -- the user can begin typing in the field, whereupon the list will be filtered to show only values containing the typed text. To change an entered value, the user must simply clear the field, and the full dropdown list will appear again. If the user needs a value not included in the list (for example, "message in a bottle") they can type it in manually.

	"suggestedvalues": [
		"Journal",
		"Livre",
		"Journal",
		"Magazine"
	]

Note: if neither "required", "suggested" nor "deprecated" are set as true for a parameter, its status will show as "optional" in the TemplateData documentation.

Une fois que vous avez terminé, appuyez sur "Enregistrer". Si vous avez fait des erreurs, vous ne pourrez pas sauvegarder (ce qui est perturbant mais signifie que vous ne pouvez rien casser). Si vous rencontrez des erreurs, expliquez sur la page feedback ce que vous avez essayé de faire, et nous serons heureux de vous aider.

Signalons que si vous abusez d’un modèle astucieux pour générer dynamiquement les TemplateData, il ne pourra pas y avoir de vérification des erreurs avant la sauvegarde.

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

Paramètre de type

Le paramètre "type" signale à l'éditeur de modèles la nature de la valeur d'un paramètre. In some cases, template editors have been programmed to modify the user interface for a certain parameter according to this TemplateData value, such as to only allow the user to enter valid values that match the specified type. Ce paramètre n'a pas de conséquence sur le paramètre du modèle ni sur sa valeur; il contrôle simplement la manière dont les éditeurs de modèles voient et traitent le paramètre en mode édition.

Comment l'utiliser

It is used by adding the "type" parameter, followed by a colon and a space, then adding any of the values listed in the table below in quotation marks.

Exemple :

"type": "string",

Effets

As of February 2020, only 5 of the 13 type values have visible effects in VisualEditor and the 2017 wikitext editor, while 8 have visible effects in TemplateWizard.

The effects of certain values are likely to change as the template editors get updates to support them. One such effort for VisualEditor and the 2017 wikitext editor is tracked in the Phabricator task T55613. A similar effort to get TemplateWizard to support the boolean value is tracked in T200664.

Les effets actuellement connus sont listés ci-après.

Valeur Description
unknown

"unknown" est la valeur du type par défaut utilisée quand le type n'est pas indiqué. On peut aussi le déclarer manuellement en saisissant "type": "unknown".

Effets

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "unknown" has no visible effects compared to a template without TemplateData.

number

La valeur "number" sert pour les valeurs numériques, y compris pour les valeurs négatives et décimales.

Effets

  • Dans l'Editeur visuel et l'éditeur de wikicode 2017, "number" n'a pas d'effet visible.
  • In the 2010 wikitext editor with TemplateWizard, "number" causes the input box to display a "+" and "-" button on either side, which can raise or lower a number value in the input box, and the user can only type numbers into the box.
Les boutons permettent aussi d'atteindre les valeurs numériques négatives.

Avec d'autres paramètres

  • In the 2010 wikitext editor with TemplateWizard, "number" overrides the effects of "autovalue"; the value of "autovalue" will not be automatically placed in the input box if the parameter type is "number".
string

La valeur "string" est utilisée pour toute chaîne de texte brut.

Effets

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "string" has no visible effect compared to "unknown".

line

La valeur "line" est utilisée pour un contenu qui doit rester sur une ligne.

Effets

  • In VisualEditor and the 2017 wikitext editor, "line" prevents a parameter's input box from allowing new lines, which are usually possible in these editors.
  • Dans l'éditeur de wikicode 2010 avec le TemplateWizard, "line" n'a pas d'effet visible (par défaut les boîtes de saisie ne permettent pas de passer à la ligne dans cet éditeur).
boolean

La valeur "boolean" est utilisée pour une valeur qui est soit vraie, fausse ou inconnue. Le manuel indique qu'elle sera représentée par un 1, 0 ou une valeur vide.

Effets

Comme depuis février 2020, aucun éditeur principal de Wikimedia (parmi le VisualEditor, l'éditeur de wikicode 2017 ou celui de 2010 avec TemplateWizard) n'utilisent cette valeur. Il n'a pas d'effet visible.

Avec autovalue:0 une case à cocher apparaît dans l'Editeur Visuel qui peut être activé ou désactivé.

date

The "date" value is intended for a date in the YYYY-MM-DD (ISO 8601) format; for example, 2014-05-22. The TemplateData manual also designates it as being intended for ISO 8601 date–time combinations, such as 2014-05-22T16:01:12Z", but in practice no major editing interface as of February 2020 uses it in this fashion, and almost all major Wikimedia template parameters take dates and times separately.

Effets

  • Dans l'Editeur visuel et l'éditeur de wikicode 2017, "date" n'a pas d'effet visible.
  • In the 2010 wikitext editor with TemplateWizard, "date" makes the parameter input box about a third shorter and adds a dropdown calendar, allowing the user to choose a date input. It also displays the grey example text in the input box "YYYY-MM-DD". If an input does not conform to this standard, the box glows red, however the editor will always output a date conforming to the standard (if numbers are entered) or nothing (if only text or nothing is entered).

Avec d'autres paramètres

  • In the 2010 wikitext editor with TemplateWizard, "date" overrides the effects of "autovalue"; the value of "autovalue" will not be automatically placed in the input box if the parameter type is "date".
url

La valeur "url" est utilisée pour les URLs, en leur ajoutant le protocole Internet (tel que « https:// » ou « // »).

Effets

  • In VisualEditor and the 2017 wikitext editor, "url" makes the input box display an external link icon (a square with arrow pointing out of it) in the left hand side of the box and makes the box glow red when the user clicks away without entering a URL value that includes a valid Internet protocol (e.g., "https://", "ftp://" or "//") followed by some text.
This second effect is similar to that of the "required" setting, but it does not warn the user if they attempt to insert the template without a valid URL. Cela se produit également dès que l'on met à jour un état (comme « suggested" » ou « deprecated »).
  • Dans l'éditeur de wikicode 2010 avec le TemplateWizard, "url" n'a pas d'effet visible.

Avec d'autres paramètres

  • In VisualEditor and the 2017 wikitext editor, "autovalue" overrides the visible effects of "url": when both are set, the input box will not contain a URL icon nor glow red when the user clicks away without entering a valid URL.
wiki-page-name

La valeur "wiki-page-name" est utilisée pour le nom d'une page de wiki.

Effets

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "wiki-page-name" makes the parameter input box show a suggestion dropdown menu containing a list of pages on the wiki, such as articles on Wikipedia, which can be selected. Les espaces de noms peuvent également être définis dans la recherche. En plus, dans l'Editeur visuel et dans l'éditeur de wikicode 2017, cela force la boîte de saisie à n'occuper qu'une seule ligne. Il n'a pas d'autre effet visible et n'empêche pas d'entrer autre chose qu'une page.

wiki-file-name

La valeur "wiki-file-name" est utilisée pour le nom d'un fichier hébergé soit localement sur un wiki, soit sur Wikimedia Commons.

Effets

  • Dans l'Editeur visuel et l'éditeur de wikicode 2017, "wiki-file-name" n'a pas d'effet visible.
  • In the 2010 wikitext editor with TemplateWizard, "wiki-file-name" makes the parameter input box show a suggestion dropdown menu containing a list of files hosted both locally and on Wikimedia Commons, which can be selected.
Les noms de fichier ne contiennent pas le préfixe de l'espace de noms « File: ». Le menu déroulant affiche aussi la vignette des fichiers. Il n'a pas d'autre effet visible et n'empêche pas d'entrer autre chose qu'un fichier.
wiki-template-name

La valeur "wiki-template-name" est utilisée pour le nom du modèle.

Effets

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "wiki-template-name" makes the parameter input box show a suggestion dropdown menu containing a list of templates, which can be selected. En plus, dans l'Editeur visuel et dans l'éditeur de wikicode 2017, cela force la boîte de saisie à n'occuper qu'une seule ligne. Il n'a pas d'autre effet visible et n'empêche pas d'entrer autre chose qu'un modèle.

wiki-user-name

La valeur "wiki-user-name" est supposée être un nom d'utilisateur du wiki.

Effets

In all main editors (VisualEditor, 2017 wikitext editor and the 2010 wikitext editor with TemplateWizard), "wiki-user-name" makes the parameter input box show a suggestion dropdown menu containing a list of actual users' names, which can be selected. En plus, dans l'Editeur visuel et dans l'éditeur de wikicode 2017, cela force la boîte de saisie à n'occuper qu'une seule ligne. Il n'a pas d'autre effet visible et n'empêche pas d'entrer autre chose qu'un nom d'utilisateur.

content

La valeur "content" sert au wikicode du contenu de la page, par exemple les liens, les images ou la mise en forme du texte.

Effets

  • Dans l'Editeur visuel et l'éditeur de wikicode 2017, "content" n'a pas d'effet visible.
  • In the 2010 wikitext editor with TemplateWizard, "content" makes the parameter input box one line taller and allows new lines, which regular input boxes in the 2010 wikitext editor do not.
unbalanced-wikitext

The "unbalanced-wikitext" value is intended for wikitext that cannot stand alone, i.e. it lacks an opening or closing tag or refers to other parts of wikitext.

Actions

  • Dans l'Editeur visuel et l'éditeur de wikicode 2017, "unbalanced-wikitext" n'a pas d'effet visible.
  • In the 2010 wikitext editor with TemplateWizard, "unbalanced-wikitext" makes the parameter input box one line taller and allows new lines, which regular input boxes in the 2010 wikitext editor do not.

Formats personnalisés

When editing the "format" value, you create custom formats by inputting a set of wikitext symbols using some predefined rules.

  • {{ - début du modèle
  • _ - contenu (comme, chaîne, entier ou paramètre). This underscore serves to indicate the minimum length of a value in characters and can be repeated, like _______. Si cette longueur n'est pas atteinte, les caractères restants sont remplacés par des espaces. Ceci peut être utilisé pour aligner tous les signes égal sur une position spécifique après un paramètre (dans le cas où on utilise \n pour de nouvelles lignes).
  • | - pipe (barre verticale qui sépare les paramètres)
  • = - signe égal (précède la valeur d'un paramètre)
  • \n or pressing the enter key - new line (this will display as in the entry field)
  • - espace (peut être utilisé avec \n pour indenter les nouvelles lignes)
  • }} - fin du modèle

The wikitext should at least meet the minimum of {{_|_=_}}, otherwise there will be an invalid format string error.

Exemples de formats que vous pouvez utiliser
Objectif Chaîne de format Rendu
Formatage en ligne {{_|_=_}}
inline
{{Foo|bar=baz|qux=quux}}{{Bar}}
Formatage en bloc {{_\n| _ = _\n}}
block
{{Foo
| bar = baz
| qux = quux
}}{{Bar}}
Pas d’espace avant le nom du paramètre,

chaque modèle sur sa propre ligne

\n{{_\n|_ = _\n}}\n
{{Foo
|bar = baz
|qux = quux
}}
{{Bar}}
Indenter chaque paramètre {{_\n |_ = _\n}}
{{Foo
 |bar = baz
 |qux = quux
}}{{Bar}}
Aligner tous les noms de paramètres à une longueur donnée {{_\n|_______________ = _\n}}\n
{{Foo
|bar             = baz
|qux             = quux
|veryverylongparameter = bat
}}
{{Bar}}
Les caractères barre verticale mis à la fin de la ligne précédente {{_|\n _______________ = _}}
{{Foo|
  bar             = baz|
  qux             = quux}}{{Bar}}
Style en ligne avec plus d’espaces, doit être au début de la ligne. \n{{_ | _ = _}}
{{Foo | bar = baz | qux = quux}}
{{Bar }}
Modèle au début de la ligne, paramètres indentés et alignés, barre verticale sur la ligne précédente. \n{{_ |\n _______________ = _}}
{{Foo |
  bar             = baz |
  qux             = quux}}
{{Bar}}

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 incluses.

<templatedata>
{
    "description": "",
    "params": {
        "1": {
            "label": "",
            "description": "",
            "type": ""
        },
        "2": {
            "label": "",
            "description": "",
            "type": ""
        }
    }
}
</templatedata>

Erreurs

Erreur de syntaxe dans JSON. / Bad JSON format (Erreur syntaxique JSON / Mauvais format JSON)

Ces erreurs apparaissent lorsque vous sauvegardez TemplateData, souvent modifié manuellement, avec du code JSON présent non valide (clés ou paramètres dupliqués, virgules absentes ou en trop, etc...) dans l'Editeur Visuel ou l'éditeur de wikicode 2017.

"Erreur de syntaxe dans JSON." apparaît dans VisualEditor et l'éditeur wikitext 2017 ; "Bad JSON format" apparaît lors de l'édition dans l'éditeur GUI de TemplateData.

These errors can be difficult to detect and come in too many forms to list. The best way to avoid them is to edit template data exclusively with the TemplateData editor; the best way to detect them once they've occurred is to use an external JSON validator, such as JSONLint, which will highlight errors and aid in fixing them.

The 2010 wikitext editor does not check for invalid JSON thanks to an old, unfixed bug (tâche T128029). Les pages contenant du code JSON non valide affichent des messages d'alarme « Erreur interne ». Pour corriger ces erreurs, le plus simple est d'utiliser un valideur de code JSON (voir ci-dessus).

Required property "paramOrder(number)" not found. (La propriété requise "ParamOrder(number)" n'a pas été trouvée)

This error occurs if you state a parameter in "params" that is not stated in "paramOrder". The number in the square brackets refers to the parameter in "paramOrder" that is missing. It refers to its order in the sequence, but it is one less than its actual position, since "paramOrder" is an array; 0 is the first one, 1 is the second, etc.

"params": {
    "date": { ...
    },
    "reason": { ...
    },
    "talk": { ... // <-- This parameter is not stated in "paramOrder", but it should be.
    }
},
"paramOrder": [
	"date",
	"reason"
]

// Erreur: Required property "paramOrder[2]" not found. (la propriété   n'existe pas)

To fix this, make sure all parameters stated in "params" are listed in "paramOrder". Vous pouvez aussi supprimer l'objet "paramOrder" pour supprimer cette erreur.

Invalid value for property "paramOrder(number)". (Valeur incorrecte de la propriété "paramOrder(numéro)").

Cette erreur apparaît si vous utilisez un paramètre dans "paramOrder" qui n'est pas utilisé dans "params". The number in the square brackets refers to the parameter in "paramOrder" that shouldn't be there. It refers to its order in the sequence, but it is one less than its actual position, since "paramOrder" is an array; 0 is the first one, 1 is the second, etc.

"params": {
    "date": { ...
    },
    "talk": { ...
    }
},
"paramOrder": [
	"date",
	"reason", // <-- Ce paramètre n'est pas évoqué dans "params", mais il le devrait.
    "talk"
]

// Erreur : valeur non valide pour la propriété «  paramOrder[1] ».

Pour corriger ceci, assurez vous que tous les paramètres présents dans "paramOrder" sont listés dans "params". Vous pouvez également supprimer l'objet "paramOrder" pour éliminer cette erreur.

Property "params.parametername.required" is expected to be of type ""boolean"". (La propriété "params.parametername.required" doit être de type ""boolean"".)

This error occurs if you put quotation marks around the value of either "required" or "suggested".

"suggested": "true" // <-- Ces points d'interrogation ne doivent pas être ici.

Ce sont des valeurs booléennes et non des chaînes de caractères; c'est pourquoi elles n'ont pas besoin de guillemets. To fix this, remove any quotation marks around the values true or false for these parameters.

Property "format" is expected to be ... (La propriété "format" est normalement...)

If the "format" parameter exists but its value is not "inline", "block" or a valid format string, you will see the error message "La propriété « format » doit être « inline », « block » ou une chaîne de format valide.".

"format": "notinline"

// Erreur : la propriété « format  » suppose valoir « inline  », « block  », ou tout autre chaîne au format valide.

To fix this, make sure the value after "format": equals "inline" or "block" and that there no spelling mistakes. Alternatively, if it's wikitext, make sure it contains a minimum of {{_|_=_}} and that there are no mistakes in the syntax that would normally cause a template to fail, such as duplicate equals signs or missing/duplicate curly brackets; see the section #Custom formats for the syntax for custom formats. Vous pouvez également supprimer le paramètre "format" pour faire disparaître cette erreur.

Unexpected property "parametername". (Propriété inattendue "NomDuParamètre".)

Cette erreur apparaît lorsque vous utilisez un paramètres qui n'est pas dans les TemplateData. Ceci est probablement du à des erreurs de prononciation.

<templatedata>
{
    "description": "",
    "format": "inline",
    "params": {
        "1": {
            "label": "",
            "descriptino": "", // <-- erreur de prononciation
            "type": ""
        }
    }
}
</templatedata>

It also occurs if you state a parameter in any TemplateData object that is not a parameter of that object. This may be due to spelling mistakes, or you may have written the parameter of one TemplateData object under another object that it doesn't belong to.

Par exemple, il est possible que vous ayez déclaré le paramètre "label" à la racine de l'objet TemplateData au lieu de le mettre à l'intérieur de "params" :

<templatedata>
{
    "description": "",
    "format": "inline",
    "label": "", // <-- paramètre mal positionné
    "params": {
        "1": { // ↓ it should be in here
            "description": "",
            "type": ""
        }
    }
}
</templatedata>

De manière similaire, si le paramètre inattendu se trouve sous un paramètre du modèle à l'intérieur de "params", vous verrez son nom après "params.NomDuParamètre." dans l'erreur.

Pour corrigez cela, vérifiez qu'ils n'y a pas de fautes d'orthographe dans les moms des paramètres, et vérifiez aussi que ces paramètres sont positionnés correctement. Assurez-vous aussi que vous n'utilisez aucun paramètre en dehors de ceux déclarés dans l'objet TemplateData. Vous pouvez voir les paramètres existants pour un objet dans la section Paramètres des TemplateData.

Required property "params" not found. (La propriété requise "params" n'a pas été trouvée.)

Cette erreur (Propriété "params" demandée mais non trouvée) apparaît quand il n'existe pas d'objet "params" dans les TemplateData. Ceci est un objet nécessaire, car il contient tous les détails de chaque paramètre, donc pour corriger cette erreur, assurez-vous qu'il est bien ajouté et qu'il n'y a pas de fautes d'orthographe. Voir la section ci-dessus sur la manière d'ajouter le paramètre "params".

Limitations et avis

  • Fonctionnalités manquantes – TemplateData est vraiment un exemple d’outil qui a été créé avec de peu de 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 dans l'affichage des modèles – Après que TemplateData a é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 aucun changement 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.

Autres outils

Aide:Extension:Assistant de modèle
Une fenêtre de dialogue de la barre d'outils pour entrer le code wiki du modèle via un formulaire construit à partir de TemplateData.
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.