Aide:Modèles/Création

Recommandations

La création d'un nouveau modèle dans l'encyclopédie doit obéir à quelques règles essentielles :

• Il faut l'écrire efficacement dans le langage MediaWiki, sinon il ne fonctionnera pas !
• Il faut qu'il y ait un réel besoin de ce modèle, sinon il ne sera jamais utilisé et sombrera dans l'oubli.
• Il faut en faciliter l'usage. Un modèle utile et bien conçu doit pouvoir être utilisé par des contributeurs qui débutent en informatique, et pas des pros du codage.
• Il faut le documenter (ce qui revient en fait au point précédent). Utiliser un modèle qui n'est pas documenté n'est jamais facile.

Pour en savoir plus, consulter : Comment documenter un modèle ?

Syntaxe

page du modèle

Le code du modèle peut être situé entre une balise <includeonly> et une balise </includeonly> si on ne veut pas que le modèle s'affiche sur la page du modèle. La description du modèle doit être située soit sur la page du modèle entre une balise <noinclude> et une balise </noinclude>, soit dans une page nommée "nom du modèle/documentation" dans ce cas, il faut ajouter <noinclude>{{Documentation}}</noinclude> au début de la page du modèle.

paramètre

Les utilisateurs du modèle peuvent définir des paramètres au modèle (par exemple dans {{exemple|hello=abc}} le paramètres est hello) pour les intégrer dans le rendu du modèle, il faut utiliser {{{nom du paramètres}}}. Dans l'exemple ci-dessus, {{{hello}}} donnerait : "a123".
Pour savoir si l'utilisateur a défini un paramètres, il faut utiliser {{#if:{{{paramètres|}}}|retour si l'attribut existe|retour si l'attribut n'existe pas}}. Dans l'exemple ci-dessus, {{#if:{{{hello|}}}|a|b} donnerait : "a" et {{#if:{{{bonjour|}}}|a|b} donnerait "b".

Fonctions de maths

Il existe plusieurs fonctions mathématiques qui permettent de calculer différentes choses. Elles doivent être placées entre {{#expr: et }}. Par exemple :

• {{#expr: 12 + 5}} retourne 17
• {{#expr: 10 - 3}} retourne 7
• {{#expr: 6 * 7}} retourne 42
• {{#expr: 100 / 5}} retourne 20
• {{#expr: 3 + 5 * 2}} retourne 13
• {{#expr: (3 + 5) * 2}} retourne 16

Mais aussi(1 = Oui et 0 = non) :

• {{#expr: 4 > 2}} retourne 1
• {{#expr: 4 < 2}} retourne 0
• {{#expr: 4 = 2}} retourne 0
• {{#expr: 4 != 2}}(!= permet d'écrire ≠) retourne 1
• {{#expr: 4 <= 2}}(<= permet d'écrire ≤) retourne 0
• {{#expr: 4 >= 2}}(>= permet d'écrire ≤) retourne 1

Pour permettre d'avoir "oui" ou "non" en réponse

• {{#ifexpr: 4 > 2|oui|non}} retourne oui (si 4 est plus grand que 2 alors retourner oui sinon retourner non)

#if,#ifeq,#ifexist...

• Pour savoir si un paramètre existe, on peut utiliser {{#if:}}(voir plus haut).
• Pour savoir si la valeur un paramètre est égale à une valeur, on peut utiliser {{#ifeq:{{{paramètre}}}|valeur à tester|résultat si la valeur du paramètre est égale à la valeur à tester|résultat si la valeur du paramètre n'est pas égale à la valeur à tester}}.

Par exemple {{#ifeq:{{{abc}}}|bla|oui|non}} retourne "oui" si abc est égal à "bla" et "non" sinon.

• Pour savoir si un article existe, on peut utiliser {{#ifexist:nom de la page|résultat si la page existe|résultat si la page n'existe pas}}

Par exemple {{#ifexist:Aide:Modèles|oui|non}} retourne "oui".

En pratique

Le plus simple est d'observer comment sont conçus les modèles existant déjà et de se baser dessus. Le plus raisonnable est de concevoir une page bac à sable en sous-page de son nom d'utilisateur. Ainsi, les essais ne perturberont pas l'espace encyclopédique.

Décoder

En observant un modèle déjà existant, on peut essayer de comprendre à quoi servent les mots et signes étranges qui le composent. En le recopiant et en introduisant des variations simples, on peut, grâce à une démarche essai-erreur, parvenir à un résultat qui nous convient.

Outils

Pour améliorer son modèle, voici des pages d'aides qui peuvent être utiles :

• Aide:Tableau, pour organiser l'espace.
• Aide:Couleurs, pour égayer le modèle.
• Aide:Mot magique, pour automatiser certaines choses !