Aide:Extension:Assistant de modèle
Qu'est-ce que l'Assistant de modèle ?
L'Assistant de modèle (TemplateWizard) est une extension MediaWiki qui fournit une boîte de dialogue pour permettre l'insertion de modèles dans le Wikitexte , à partir de la barre d'outils de l'Éditeur wiki.
Comment utiliser l'Assistant de modèle ?
- Pour utiliser l'Assistant de modèle, éditez une page wiki avec l'éditeur wiki (qui n'est pas l'éditeur visuel 2017)
- placez le curseur à l'endroit où vous voulez insérer le modèle. Puis cliquez sur l'icône en forme de puzzle
dans la barre d'outils -
- une boîte de dialogue apparaîtra
Comment trouver un modèle ?
- Commencez à entrer le nom du modèle pour avoir accès à une liste de modèles que vous pourrez choisir.
- Note : Seuls les modèles utilisant TemplateData auront une description. Nous vous encourageons à ajouter les informations TemplateData aux modèles.
- Quand vous avez trouvé le modèle que vous recherchez, cliquez dessus (ou utilisez les flèches pour vous déplacer) et appuyez sur Entrée. Ceci vous amènera au formulaire d'entrée des données.
Comment ajouter des données au modèle choisi ?
- La barre supérieure que vous voyez maintenant contient le titre du modèle, la description, un lien
vers la page wiki du modèle, et un bouton de fermeture
pour fermer le formulaire et revenir à la recherche.
La liste de paramètres du côté gauche, est divisée au plus en trois parties relatives aux paramètres obligatoires, suggérés, et optionnels. Cette zone possède également un bouton en bas avec lequel vous pouvez ajouter ou supprimer d'un seul coup, l'ensemble des champs non obligatoires. Notez que certains modèles n'ont pas de paramètres, et dans ce cas rien ne sera listé ici. Si vous cliquez sur un paramètre de modèle, il vient s'ajouter au côté droit.
Le formulaire de droite qui contient les champs actuels de saisie de données dans lesquels vous entrez les valeurs qui seront ajoutées au texte wiki. Seuls les paramètres listés ici seront insérés dans la zone dédition (y compris ceux qui n'ont pas de valeur assignée, parce que le modèle peut les traiter différemment des paramètres réellement absents).
Vous pouvez cliquer sur les icônes d'information au-dessus des champs du modèle pour en savoir davantage.
$screenshotinfo
TemplateWizard fonctionne particulièrement bien avec les modèles qui définissent TemplateData : c'est à dire que leur paramètres ont été documentés d'une manière détaillée et structurée, y compris leur valeur par défaut etc. (les informations sur la manière de faire cela sont décrites sur les pages d'aide de TemplateData). TemplateWizard fonctionne également sans les définitions de TemplateData, mais avec certaines fonctionalités réduites. Ces deux modes sont décrits dans les sections suivantes.
Utilisation de TemplateWizard avec TemplateData
Il existe 7 (sept) types différents de champs utilisés dans TemplateWizard, basés sur le type de paramètre défini dans TemplateData.
Nom[fn 1] | Type[fn 2] | Champ utilisé | Notes | |
---|---|---|---|---|
1. | Nombre | number |
NumberInputWidget | |
2. | Date | date |
DateInputWidget | |
3. | Utilisateur | wiki-user-name |
UserInputWidget | |
4. | Page | wiki-page-name |
TitleInputWidget | Pour tous les noms de page (y compris les fichiers). |
5. | Fichier | wiki-file-name |
TitleInputWidget | Limité aux titres dans l'espace de noms des fichiers, et affichés avec les vignettes. |
6. | Modèle | wiki-template-name |
TitleInputWidget | Limité aux titres de l'espace de noms « Template » . |
7. | Tout autre chose | TextInputWidget | Tous les autres types seront affichés comme des entrées de texte classiques et accepteront n'importe quel texte. | |
TemplateData lui-même prend en charge davantage de types de champs que ceux listés ci-dessus. Certains d'entre eux peuvent être ajoutés dans tâche T200664.
Utiliser TemplateWizard sans TemplateData
Si un modèle ne possède pas de TemplateData, alors une tentative sera faite pour deviner les noms de ses paramètres, et ils seront présentés sous forme de champs de saisie de formulaire texte classique avec les libellés supposés.
Notez que très vraisemblablement il y aura des paramètres en double, obsolètes, ou absents dans cette liste, parce que les auteurs des modèles pourront faire les choses suivantes pour permettre d'avoir un nom de paramètre sous différentes formes : {{{full name|{{{Full Name}}}}}}
(notez la différence dans la casse). Il est habituel pour eux d'avoir une forme de paramètre préférée, et vous ne pouvez savoir ceci qu'en lisant la documentation du modèle (et tant que vous y êtes, peut être d'ajouter TemplateData, afin que les personnes suivantes ne soient pas troublées à l'avenir !).
It is common for there to be a prefered form for a parameter, and this can only be found by viewing the template documentation (and, while you're there, maybe adding TemplateData, so other people aren't confused in the future!).
Comment insérer le modèle ?
Lorsque vous avez ajouté au formulaire du modèle tous les paramètres désirés, et que vous avez fixé leur valeur (ou n'en n'avez pas donné du tout si vous avez besoin de paramètres vides), cliquez sur le bouton 'Submit' dans le coin supérieur droit de la fenêtre de dialogue et le texte wiki du modèle sera inséré à la position courante du curseur dans la boîte d'édition de la page d'accueil.
Le texte du modèle sera inséré en fonction du format défini dans TemplateData; s'il n'y en a aucun, alors le format 'inline' sera utilisé. Il n'est pas possible d'avoir un format utilisateur différent pour un modèle (mais bien sûr, le texte wiki du modèle peut toujours être modifié après l'insertion).
Voir aussi
- Help talk:Extension:TemplateWizard – forum d'aide à l'utilisateur final de l'extension.
- Extension:TemplateWizard – page d'accueil de l'extension, dédiée aux administrateurs système et aux développeurs.
- Phabricator:tag/TemplateWizard – système de gestion des problèmes pour les bogues et les fonctionalités absentes.