LINUX:MediaWiki - Modèle
But
Un des espaces de noms énoncés au chapitre précédent est aussi le modèle. Un modèle est une page paramétrable qui peu être utilisée dans d'autres pages avec un aspect standardisation teinté de personnalisation.
Concept
Un modèle est une page classique dans son concept mais qui a pour finalité d'être utilisée de multiples fois. Dans une page classique, on peut inclure à divers endroits divers modèles. Une autre caractéristique non exigible est son paramétrage. Un modèle peut fonctionner comme une fonction en programmation. On lui passe un certain nombre de paramètres qui vont permettre de personnaliser ce modèle. Ces paramètres peuvent nommés ou utilisés selon leur ordre d'apparition.
Ce concept de modèle est utilisé d'office dans l'extension "Semantic-Mediawiki" mais ils peuvent très bien être utilisés hors de cette application.
Par exemple, on peut ajouter en bas d'une page, une série de liens externes vers divers réseaux sociaux.
Mise en oeuvre
La création de ces pages à usage comme modèle sont à mettre de préférence dans l'espace de nom "Modèle" (ou 'Template"). Mais il est possible d'utiliser de façon simple toute page.
Sans paramètre
On crée une page comme on le fait classiquement. on va la nommer par exemple "Description".
Dans la page qui veut l'inclure, on place à l'endroit désiré, le référence à ce modèle en plaçant son nom de mage entre doubles accolades.
Par exemple:
{{Description}}
Avec paramètres ordonnées
Pour rendre plus dynamique, plus personnalisable les modèles, on peut lui passer des paramètres.
La première solution, la plus facile est de lui passer seulement les valeurs des paramètres. Dans ce cas, ils doivent arriver dans le bon ordre car ils vont être utilisés selon leur ordre d'arrivée.
Au niveau de la page appelante, on ajoute derrière l'appel du modèle, les diverses valeurs des paramètres. Ils sont séparées par un barre verticale ("|").
Par exemple pour passer le nom et le prénom d'une personne au modèle "Elève", on a:
{{Elève|Rousseau|Antoine}}>
Du côté du modèle, on va intégrer ces paramètres tel des variables nommés selon leur n° d'ordre. Ces n° seront entourées d'une triple accolades.
Par exemple:
Le nom de l'élève est {{{1}}} et son prénom est {{{2}}}.
L'affichage final devient:
Le nom de l'élève est Rousseau et son prénom est Antoine.
Avec paramètres nommés
L'autre méthode consiste à passer les paramètres via un couple <nom de paramètre>=<valeur>. Dans ce cas l'ordre n'a pas d'importance et au lieu d'un n° d'odre, le référencement se fera via le nom.
Si nous reprenons l'exemple précédent.
Au niveau de l'appelant, nous avons:
{{Elève|prenom=Antoine|nom=Rousseau}}>
L'ordre a été inversé intentionnellement.
Et au niveau du modèle:
Le nom de l'élève est {{{nom}}} et son prénom est {{{prenom}}}.
Modèle hors de l'espace de noms "Modèle"
Par exemple, on désire inclure la page "Accueil" qui est la page d'entrée par défaut d'un Wiki dans une page quelconque, on met:
{{:Accueil}}
Autre exemple, on désire inclure la page "Liste adresses" de l'espace de nom "PERSONNE", on met:
{{PERSONNE:Liste adresses}}
Note: Je n'est pas essayé avec des paramètres.
Liste des modèles
Pour les modèles de l'espace de nom "Modèle", le moyen classique d'obtenir une liste des modèles consiste à aller dans les "Pages spéciales" (menu de gauche). Dans cet écran, on peut les trouvez dans la même section, sous la rubrique "Toutes la pages". Dans la liste d'Espace de noms", choisissez l'entrée "Modèle"; on valide par le bouton "Lister" pour les afficher.
Si on a installé l'extension "PageForms", une nouvelle section s'affiche: "Formulaires de pages". Cette extension est très utile si pas nécessaire à l'extension "Semantic-Mediawiki". La rubrique "Modèles" permet d'y accéder. Dans cet environnement, ils sont souvent couplés à une catégorie.