FANDOM


Cette fonctionnalité est activée par défaut sur Fandom.

Une « fonction parseur » est un bout de code spécial dans MediaWiki qui permet d'étendre les fonctionnalités d'un modèle afin de réaliser des opérations logiques. Lors du rendu, les fonctions parseur utilisent les paramètres définis afin d'imprimer un résultat.

Les fonctions parseur s'écrivent de la même manière que les modèles, encadrées d'accolades. Elles sont facilement identifiables par la présence de deux points (:) ou d'un dièse (#) dans le nom de la fonction (ou les deux, comme dans le cas de la fonction {{#if:}}).

Une liste de toutes les fonctions parseur qu'il est possible d'utiliser sur une communauté est disponible sur la page Spécial:Version.

Utilisation pas à pas Modifier

  1. Identifiez la fonction parseur appropriée à la tâche que vous souhaitez accomplir. Il existe une large variété de fonctions parseur, alors faites bien vos recherches.
    À la fin de ces instructions se trouvent des informations supplémentaires avec des liens pour vous rediriger vers des documentations complètes concernant chaque fonction parseur.
  2. Identifiez la syntaxe correcte pour la fonction parseur que vous souhaitez utiliser.
    Dans ce guide, nous utiliserons la fonction parseur {{#ifexpr:}} (expression « if »), qui est activée par défaut sur chaque wiki. Sa syntaxe est :
    {{#ifexpr: expression | valeur si vrai | valeur si faux }}
  3. Complétez la syntaxe.
    {{#ifexpr: 1 > 0 | oui | non }}
    Dans l'exemple ci-dessus, nous l'avons complété avec une expression mathématique (1 > 0), réglé la fonction pour répondre « oui » si 1 > 0 est mathématiquement correcte et pour répondre « non » si 1 > 0 est mathématiquement incorrecte.
  4. Publiez la page et vérifiez que la fonction semble retourner la valeur attendue. Dans notre exemple, « oui » doit être retourné car 1 est effectivement plus grand que 0.
    {{#ifexpr: 1 > 0 | oui | non }}oui.
    Notez ce qu'il se passe si on inverse l'expression sans changer les valeurs. L'équation est fausse puisque 0 n'est pas plus grand que 1 donc la fonction retourne « non. »
    {{#ifexpr: 1 < 0 | oui | non }}non.

Si l'exemple ci-dessus peut paraître idiot, car tout le monde sait que 1 > 0, la puissance de la fonction parseur se révèle lorsqu'on passe un paramètre. Disons que vous êtes en train de créer une infobox pour une communauté dont le thème est une série télévisée. Vous souhaitez ajouter l'âge d'un personnage et déterminer s'il est adulte ou non.

Si dans l'infobox vous avez {{#ifexpr: {{{Age}}} >= 18 | Ce personnage est adulte. | Ce personnage n'est pas adulte. }}, le code affichera « Ce personnage est adulte. » si l'âge indiqué est 18 ou plus. Si l'âge donné est inférieur à 18, le code affichera « Ce personnage n'est pas adulte. »

Fonctions parseur intégrées dans MediaWiki Modifier

Le logiciel MediaWiki lui-même intègre de multiples fonctions parseur en son sein. Une liste complète de ces fonctions est disponible sur MediaWiki.org

{{fullurl:}}
Retourne l'URL complète d'une page donnée.
{{fullurl:Aide:Contenu}}https://communaute.fandom.com/fr/wiki/Aide:Contenu
{{#language:}}
Convertit un code de langue en nom de la langue.
{{#language:es}} → Español
{{lc:}}
Change une chaîne de caractère en minuscule (opposé de {{uc:}}).
{{lc:CASSE}} → casse
{{ns:}}
Lit le numéro d'un espace de noms et indique de quel espace de noms il s'agit.
{{ns:4}} → Centre des communautés
{{plural:}}
Si l'expression indiquée est égale à un, retourne la valeur au singulier donnée. Si l'expression indiquée est égale à deux, retour la valeur au pluriel donnée.
{{plural:1|est|sont}} → est
{{plural:2|est|sont}} → sont

Extension ParserFunctions Modifier

Ifelselogic

L'extension ParserFunctions s'appuie sur une logique simple afin de retourner le code adéquat.

L'extension ParserFunctions est une extension populaire de MediaWiki qui a ajouté de nombreuses fonctions parseur utiles. Cette extension est activée par défaut sur tout FANDOM. Cette extension inclut également la plupart des fonctions parseur qui étaient fournies par l'extension StringFunctions, désormais obsolète, notamment {{#explode}}.

L'extension ParserFunctions dispose de fonctions pour des opérations mathématiques, des déclarations if/else (si/sinon) et des fonctions de temps. Pour une liste complète de ces fonctions et une documentation très utile pour les utiliser, consultez la page d'aide officiel de l'extension.

Autres extensions Modifier

D'autres extensions populaires sur FANDOM ajoutent quelques fonctions parseur. Parmi les plus communes :

  • Arrays - ajoute {{#arraydefine}}, {{#arrayprint}}, {{#arraysearcharray}}.
  • Semantic MediaWiki - ajoute {{#ask}}, {{#set}}, {{#show}}.
  • Semantic Forms - ajoute {{#formlink}}, {{#forminput}}, {{#arraymap}}
  • Simple Calendar - ajoute {{#calendar}}
  • Variables - ajoute {{#var}}, {{#vardefine}}, {{#vardefineecho}}
  • Lua - utilisez {{#invoke:}} pour utiliser le code Lua qui se trouve dans l'espace de noms Module.

Si une extension qui vous intéresse ajoute une fonction parseur, consultez la page de cette extension sur MediaWiki.org.

Voir aussi Modifier

Plus d'aideModifier

Sauf mention contraire, le contenu de la communauté est disponible sous licence CC-BY-SA  .