Centre des communautés
Advertisement
Centre des communautés

Une fonction parseur est une forme de codage basique au sein du langage MediaWiki, le wikitexte. Il permet de rendre un modèle plus robuste et adaptable. Assez bien écrite, la définition d'une fonction parseur produit des résultats différents dans des situations différentes.

Par exemple, au lieu de simplement répéter la même instruction sur chaque page où le modèle {{Mon super modèle}} est utilisé, vous pouvez utiliser une fonction parseur pour afficher un résultat si la page se trouve dans la Catégorie:Fichiers, et un résultat complètement différent si elle se trouve dans la Catégorie:Aide.

Les façons dont vous pouvez utiliser les fonctions parseur sont beaucoup trop variées pour que nous puissions les partager ici. Mais nous espérons pouvoir vous aider à les explorer.

Utilisation basique[]

Parser quelque chose est simplement examiner une expression pour ses composantes logiques et ensuite prendre des mesures en conséquence. Par exemple :

Si le nom de cet article est « Supergirl 23 », alors le champ "prochain numéro" dans l'infobox sera « Supergirl 24 ».

Ceci est une fonction parseur.

Comment en écrire une ? 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 croisillon (#) dans le nom de la fonction (ou les deux, comme dans le cas de la fonction {{#ifeq:}}).

Supposons que vous vouliez envoyer des gens à la page appelée Supergirl, à moins que vous ne soyez déjà sur cette page. Voici une façon simple de le faire :

{{#ifeq:{{PAGENAME}}|Supergirl| |Aller sur [[Supergirl]]}}

Cela signifie : "Si la page sur laquelle je me trouve s'appelle "Supergirl" (exactement), ne rien afficher. Sinon, afficher : "Allez sur [[Supergirl]]".

Mais peut-être êtes-vous en train de concevoir une infobox pour un wiki sur une série télévisée, et vous voulez faire quelques calculs simples pour agir sur la valeur de la variable {{{Âge}}}.

En mettant {{#ifexpr : {{{Âge}}} >= 18 | Ce personnage est un adulte. | Ce personnage n'est pas un adulte. }}, l'infobox pourrait indiquer « Ce personnage est un adulte » si l'âge donné du personnage est supérieur ou égal à 18 ans. Si l'âge donné est inférieur à 18 ans, le code indiquerait plutôt « Ce personnage n'est pas un adulte ».

Fonctions parseur intégrées dans MediaWiki[]

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. Cette page présentera les plus utiles.

{{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[]

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

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 ajoute de nombreuses fonctions parseur utiles. Cette extension est activée par défaut sur tout Fandom. Cette extension est activée par défaut sur l'ensemble du Fandom, vous n'avez donc pas besoin de la demander.

L'extension ParserFunctions dispose de fonctions pour des opérations mathématiques, des déclarations if/else (si/sinon) et même manipuler le temps lui-même ! (Enfin, l'expression du temps, en tout cas !)

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.

Fonctions String[]

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

Les Fonctions String (fonctions de chaînes de caractères) font désormais partie de l'extension ParserFunctions. Mais elles faisaient auparavant partie de leur propre extension, distincte. Ne vous embrouillez donc pas lorsque vous lisez ce qui suit. Seule l'extension StringFunctions est dépréciée. Les fonctions String elles-mêmes sont bien vivantes !

Les fonctions String sont une série de fonctions parser spécialisées qui agissent sur les chaînes de texte. Elles vous permettent de faire des choses comme :

  • déterminer la longueur d'une chaîne
  • déterminer la position qu'occupe un caractère précis dans la chaîne
  • trouver un mot entier dans une chaîne

En soi, les fonctions string peuvent sembler obscures, mais elles sont vitales lorsque vous essayez de faire quelque chose comme transformer Ant-Man (Terre-616) en seulement Ant-Man. Elles vous permettent de détecter le (Terre-616) entre parenthèses et de le supprimer !

Autres extensions[]

D'autres extensions qui sont populaires sur Fandom ajoutent leurs propres fonctions parser. Deux des plus courantes sont Arrays et Variables.

Pour en savoir plus, veuillez consulter la page de cette extension sur MediaWiki.org.

Quelles fonctions parser sont disponibles ici ?[]

Comme différents wikis peuvent avoir différentes fonctions parser, il peut être utile de savoir précisément ce qui se trouve sur un wiki particulier. Consultez Spécial:Version de votre wiki pour obtenir la liste complète.

Voir aussi[]

Plus d'aide

Advertisement