Aide:ParserFunctions - Historique des versions

Red Bull Salzbourg : rectif des coquilles les plus flagrantes

2020-12-19T02:25:09Z

rectif des coquilles les plus flagrantes

← Version précédente		Version du 19 décembre 2020 à 02:25
Ligne 1 :		Ligne 1 :
	{{Navigation aide\|Modèles}}		{{Navigation aide\|Modèles}}
	Les '''ParserFunctions''' sont des ajouts à la syntaxe wiki qui sont particulièrement ~~utilisés~~ dans les modèles. Elles servent à afficher un résultat différent en fonction de la valeur d'entrée. Il existe une dizaine de ParserFunctions différentes, mais seules les quatre principales seront ici abordées.		Les '''ParserFunctions''' sont des ajouts à la syntaxe wiki qui sont particulièrement utilisées dans les modèles. Elles servent à afficher un résultat différent en fonction de la valeur d'entrée. Il existe une dizaine de ParserFunctions différentes, mais seules les quatre principales seront ici abordées.

	== #if ==		== #if ==
Ligne 35 :		Ligne 35 :

	=== Exemple ===		=== Exemple ===
	<nowiki>#</nowiki>ifeq est utilisée dans un grand nombre de ~~modèle~~. Son utilisation la plus courante est sans doute pour les catégories. Tout modèle incluant la page où il est utilisé dans une ou plusieurs catégorie(s) doit posséder un paramètre « catégories » qui permet de désactiver les catégories en écrivant « catégories=non ». Une des manières les utilisées pour faire ça est celle-ci :<br />		<nowiki>#</nowiki>ifeq est utilisée dans un grand nombre de modèles. Son utilisation la plus courante est sans doute pour les catégories. Tout modèle incluant la page où il est utilisé dans une ou plusieurs catégorie(s) doit posséder un paramètre « catégories » qui permet de désactiver les catégories en écrivant « catégories=non ». Une des manières les plus utilisées pour faire ça est celle-ci :<br />
	<code><nowiki>{{#ifeq: {{{catégories\|oui}}} \| oui \| [[Catégorie:Bidule]] }}</nowiki></code>		<code><nowiki>{{#ifeq: {{{catégories\|oui}}} \| oui \| [[Catégorie:Bidule]] }}</nowiki></code>

	Dans ce cas, cela fonctionne de la manière suivante :		Dans ce cas, cela fonctionne de la manière suivante :
	* si « catégories » n'est pas défini, il est remplacé par « oui » et la catégorie est donc ~~inclue~~ ;		* si « catégories » n'est pas défini, il est remplacé par « oui » et la catégorie est donc incluse ;
	* si « catégories » est défini « oui », idem ;		* si « catégories » est défini « oui », idem ;
	* si catégories est défini par n'importe quoi d'autre, la catégorie n'est pas ~~inclue~~.		* si catégories est défini par n'importe quoi d'autre, la catégorie n'est pas incluse.

	== #switch ==		== #switch ==

X-Fusion : X-Fusion a déplacé la page Aide:Extension ParserFunctions vers Aide:ParserFunctions par-dessus une redirection

2018-05-15T15:25:26Z

X-Fusion a déplacé la page Aide:Extension ParserFunctions vers Aide:ParserFunctions par-dessus une redirection

← Version précédente	Version du 15 mai 2018 à 15:25
(Aucune différence)

X-Fusion le 18 mars 2018 à 22:01

2018-03-18T22:01:51Z

← Version précédente		Version du 18 mars 2018 à 22:01
Ligne 21 :		Ligne 21 :
	</pre>		</pre>

	On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le ~~comme~~ ci-dessus.		On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le code ci-dessus.

	Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>\| colspan="2" class="précision" \| {{{légende}}}</nowiki></code>, et <code><nowiki>\|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« \| ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Aide:Mot magique\|mot magique « ! »]]. Le fait de devoir remplacer ou non les barres verticales dépend de la situation. Par exemple dans un lien du style <code><nowiki>[[Nom de la page\|Texte affiché]]</nowiki></code>, il n'est pas nécessaire de le faire, tout comme si une ParserFunction est incluse dans une autre ParserFunction.		Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>\| colspan="2" class="précision" \| {{{légende}}}</nowiki></code>, et <code><nowiki>\|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« \| ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Aide:Mot magique\|mot magique « ! »]]. Le fait de devoir remplacer ou non les barres verticales dépend de la situation. Par exemple dans un lien du style <code><nowiki>[[Nom de la page\|Texte affiché]]</nowiki></code>, il n'est pas nécessaire de le faire, tout comme si une ParserFunction est incluse dans une autre ParserFunction.

X-Fusion le 25 février 2018 à 23:13

2018-02-25T23:13:01Z

← Version précédente		Version du 25 février 2018 à 23:13
Ligne 23 :		Ligne 23 :
	On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le comme ci-dessus.		On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le comme ci-dessus.

	Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>\| colspan="2" class="précision" \| {{{légende}}}</nowiki></code>, et <code><nowiki>\|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« \| ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[~~Modèle~~:!\|~~modèle~~ !]]. Le fait de devoir remplacer ou non les barres verticales dépend de la situation. Par exemple dans un lien du style <code><nowiki>[[Nom de la page\|Texte affiché]]</nowiki></code>, il n'est pas nécessaire de le faire, tout comme si une ParserFunction est incluse dans une autre ParserFunction.		Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>\| colspan="2" class="précision" \| {{{légende}}}</nowiki></code>, et <code><nowiki>\|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« \| ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Aide:Mot magique\|mot magique « ! »]]. Le fait de devoir remplacer ou non les barres verticales dépend de la situation. Par exemple dans un lien du style <code><nowiki>[[Nom de la page\|Texte affiché]]</nowiki></code>, il n'est pas nécessaire de le faire, tout comme si une ParserFunction est incluse dans une autre ParserFunction.

	== #ifeq ==		== #ifeq ==

X-Fusion le 9 décembre 2017 à 18:44

2017-12-09T18:44:37Z

← Version précédente		Version du 9 décembre 2017 à 18:44
Ligne 93 :		Ligne 93 :

	== Imbrication de ParserFunctions ==		== Imbrication de ParserFunctions ==
	~~{{Incomplet}}~~
	Il est très courant de devoir utiliser plusieurs ParserFunctions à la fois, ou en d'autres termes d'en imbriquer.		Il est très courant de devoir utiliser plusieurs ParserFunctions à la fois, ou en d'autres termes d'en imbriquer.

X-Fusion le 16 novembre 2017 à 21:10

2017-11-16T21:10:33Z

@@ Ligne 23 : / Ligne 23 : @@
 On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le comme ci-dessus.
-Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>| colspan="2" class="précision" | {{{légende}}}</nowiki></code>, et <code><nowiki>|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« | ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Modèle:!|modèle !]].
+Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>| colspan="2" class="précision" | {{{légende}}}</nowiki></code>, et <code><nowiki>|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« | ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Modèle:!|modèle !]]. Le fait de devoir remplacer ou non les barres verticales dépend de la situation. Par exemple dans un lien du style <code><nowiki>[[Nom de la page|Texte affiché]]</nowiki></code>, il n'est pas nécessaire de le faire, tout comme si une ParserFunction est incluse dans une autre ParserFunction.
 == #ifeq ==
@@ Ligne 94 : / Ligne 94 : @@
 == Imbrication de ParserFunctions ==
 {{Incomplet}}
 == Pour aller plus loin ==

X-Fusion : suite 3

2017-10-26T17:38:56Z

suite 3

← Version précédente		Version du 26 octobre 2017 à 17:38
Ligne 10 :		Ligne 10 :

	La dernière partie est facultative : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini }}</nowiki></code> fonctionne tout à fait. Dans ce cas, si <code>paramètre</code> n'est pas défini, rien se s'affichera.		La dernière partie est facultative : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini }}</nowiki></code> fonctionne tout à fait. Dans ce cas, si <code>paramètre</code> n'est pas défini, rien se s'affichera.

			<u>Attention</u> : toujours mettre une barre verticale (« \| ») après le nom du paramètre dans la première partie d'une fonction #if, sinon le paramètre sera considéré comme défini même s'il ne l'est pas.

	=== Exemple ===		=== Exemple ===
	{{~~Incomplet~~}}		On prend ici une exemple tiré de l'[[Modèle:Infobox Capacité\|infobox Capacité]] :
			<pre>
			{{#if: {{{légende\|}}} \|
			{{!}} colspan="2" class="précision" {{!}} {{{légende}}}
			{{!}}- }}
			</pre>

			On veut que la ligne où s'affiche la légende n'apparaisse que quand le paramètre « légende » est défini. Dans ce cas là, on utilise #if. C'est ce à quoi sert le comme ci-dessus.

			Cet exemple permet aussi de découvrir une remarque importante qui est valable pour toutes les ParserFunctions. D'habitude, on aurait fait cette case de tableau de cette façon : <code><nowiki>\| colspan="2" class="précision" \| {{{légende}}}</nowiki></code>, et <code><nowiki>\|-</nowiki></code> pour changer de ligne. Cependant, la barre verticale (« \| ») est un élément central des ParserFunctions et en mettre dans le texte/code à afficher perturberait le fonctionnement. Par conséquent, il faut remplacer toutes les barres verticales par le [[Modèle:!\|modèle !]].

	== #ifeq ==		== #ifeq ==
Ligne 24 :		Ligne 35 :

	=== Exemple ===		=== Exemple ===
	{{~~Incomplet~~}}		<nowiki>#</nowiki>ifeq est utilisée dans un grand nombre de modèle. Son utilisation la plus courante est sans doute pour les catégories. Tout modèle incluant la page où il est utilisé dans une ou plusieurs catégorie(s) doit posséder un paramètre « catégories » qui permet de désactiver les catégories en écrivant « catégories=non ». Une des manières les utilisées pour faire ça est celle-ci :<br />
			<code><nowiki>{{#ifeq: {{{catégories\|oui}}} \| oui \| [[Catégorie:Bidule]] }}</nowiki></code>

			Dans ce cas, cela fonctionne de la manière suivante :
			* si « catégories » n'est pas défini, il est remplacé par « oui » et la catégorie est donc inclue ;
			* si « catégories » est défini « oui », idem ;
			* si catégories est défini par n'importe quoi d'autre, la catégorie n'est pas inclue.

	== #switch ==		== #switch ==

X-Fusion le 26 octobre 2017 à 16:46

2017-10-26T16:46:57Z

← Version précédente		Version du 26 octobre 2017 à 16:46
Ligne 7 :		Ligne 7 :
	Syntaxe : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini \| texte affiché si paramètre n'est pas défini }}</nowiki></code>		Syntaxe : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini \| texte affiché si paramètre n'est pas défini }}</nowiki></code>

	La fonction #if est la plus basique. Elle sert à vérifier qu'un paramètre est défini, et à afficher quelque chose de différent si c'est la cas où si ce n'est pas le cas.		La fonction #if est la plus basique. Elle sert à vérifier qu'un paramètre est défini, et à afficher quelque chose de différent si c'est le cas ou si ce n'est pas le cas.

	La dernière partie est facultative : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini }}</nowiki></code> fonctionne tout à fait. Dans ce cas, si <code>paramètre</code> n'est pas défini, rien se s'affichera.		La dernière partie est facultative : <code><nowiki>{{#if: paramètre \| texte affiché si paramètre est défini }}</nowiki></code> fonctionne tout à fait. Dans ce cas, si <code>paramètre</code> n'est pas défini, rien se s'affichera.

X-Fusion : suite 2

2017-10-26T16:46:00Z

suite 2

← Version précédente		Version du 26 octobre 2017 à 16:46
Ligne 38 :		Ligne 38 :
	<code><nowiki>{{#switch: paramètre \| valeur1 = premier texte \| valeur2 \| valeur3 = deuxième texte \| valeur4 = troisième texte \| #default =		<code><nowiki>{{#switch: paramètre \| valeur1 = premier texte \| valeur2 \| valeur3 = deuxième texte \| valeur4 = troisième texte \| #default =
	texte par défaut }}</nowiki></code><br />		texte par défaut }}</nowiki></code><br />
	On remarque ici que <code>valeur2</code> n'a pas de texte associé. Que se passera-t-il alors si <code>paramètre</code> et <code>valeur2</code> sont identiques ? C'est ce qu'on appelle un groupe de valeurs, ici <code>valeur2</code> et <code>valeur3</code> renvoient le même texte. Le résultat sera donc ~~« troisième~~ texte ».		On remarque ici que <code>valeur2</code> n'a pas de texte associé. Que se passera-t-il alors si <code>paramètre</code> et <code>valeur2</code> sont identiques ? C'est ce qu'on appelle un groupe de valeurs, ici <code>valeur2</code> et <code>valeur3</code> renvoient le même texte. Le résultat sera donc « deuxième texte ».

	=== Exemple ===		=== Exemple ===
	{{~~Incomplet~~}}		La fonction #switch est par exemple utilisée dans le [[Modèle:Abréviation\|modèle Abréviation]]. Prenons cette partie du modèle :
			<pre>
			{{#switch: {{lc: {{{1}}}}}
			\| o \| or = [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]]
			\| oa \| or et argent = [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]][[Pokémon Argent\|{{Police\|{{{2\|a}}}\|A}}]]
			\| oac \| or, argent et cristal = [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]][[Pokémon Argent\|{{Police\|{{{2\|a}}}\|A}}]][[Pokémon Cristal\|{{Police\|{{{2\|c}}}\|C}}]]
			\| #default = {{{1\|}}}
			}}
			</pre>

			Ici, le modèle réagira de cette façon :
			* si le paramètre vaut « o » ou « or », la fonction renverra « [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]] » ;
			* si le paramètre vaut « oa » ou « or et argent », la fonction renverra « [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]][[Pokémon Argent\|{{Police\|{{{2\|a}}}\|A}}]] » ;
			* si le paramètre vaut « oac » ou « or, argent et cristal », la fonction renverra « [[Pokémon Or\|{{Police\|{{{2\|o}}}\|O}}]][[Pokémon Argent\|{{Police\|{{{2\|a}}}\|A}}]][[Pokémon Cristal\|{{Police\|{{{2\|c}}}\|C}}]] » ;
			* sinon, la fonction renverra le paramètre donné.

	== #expr ==		== #expr ==
	~~{{Incomplet}}~~
			=== Théorie ===
	Syntaxe : <code><nowiki>{{#expr: expression }}</nowiki></code>		Syntaxe : <code><nowiki>{{#expr: expression }}</nowiki></code>

			La fonction #expr permet de faire des calculs mathématiques. Les principaux opérateurs sont :
			* « + » pour une addition ;
			* « - » pour une soustraction ;
			* « * » pour une multiplication ;
			* « / » pour une division ;
			* « ^ » pour une puissance.

			=== Exemple ===
			* <code><nowiki>{{#expr: 2 * 6}}</nowiki></code> donne {{#expr: 2 * 6}}
			* <code><nowiki>{{#expr: 3 * 10^2}}</nowiki></code> donne {{#expr: 3 * 10^2}}

			On peut remplacer un nombre par un paramètre. Ainsi, pour <code><nowiki>{{#expr: {{{1}}}^2 - 10}}</nowiki></code>, la fonction renverra le carré du nombre moins 10.

	== Imbrication de ParserFunctions ==		== Imbrication de ParserFunctions ==
Ligne 51 :		Ligne 79 :

	== Pour aller plus loin ==		== Pour aller plus loin ==
	* [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions/fr La page d'aide de mediawiki.org] qui explique ~~en plus~~ le fonctionnement de ParserFunctions plus avancées : #iferror, #ifexpr, #ifexist, #reb2labs, #time, #timel et #titleparts. Ces fonctions sont très peu utilisées voire inutilisées sur Poképédia, et il n'est donc pas nécessaire de savoir les utiliser, mais il est quand même bon de retenir que d'autres ParserFunctions existent.		* [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions/fr La page d'aide de mediawiki.org] qui offre des détails sur ces fonctions et explique le fonctionnement de ParserFunctions plus avancées : #iferror, #ifexpr, #ifexist, #reb2labs, #time, #timel et #titleparts. Ces fonctions sont très peu utilisées voire inutilisées sur Poképédia, et il n'est donc pas nécessaire de savoir les utiliser, mais il est quand même bon de retenir que d'autres ParserFunctions existent.

	[[Catégorie:Aide de Poképédia]]		[[Catégorie:Aide de Poképédia]]

X-Fusion : Annulation des modifications 1143429 de X-Fusion (discussion)

2017-10-26T14:45:10Z

Annulation des modifications 1143429 de X-Fusion (discussion)

← Version précédente		Version du 26 octobre 2017 à 14:45
Ligne 1 :		Ligne 1 :
			{{Navigation aide\|Modèles}}
	Les '''ParserFunctions''' sont des ajouts à la syntaxe wiki qui sont particulièrement utilisés dans les modèles. Elles servent à afficher un résultat différent en fonction de la valeur d'entrée. Il existe une dizaine de ParserFunctions différentes, mais seules les quatre principales seront ici abordées.		Les '''ParserFunctions''' sont des ajouts à la syntaxe wiki qui sont particulièrement utilisés dans les modèles. Elles servent à afficher un résultat différent en fonction de la valeur d'entrée. Il existe une dizaine de ParserFunctions différentes, mais seules les quatre principales seront ici abordées.
	~~{{Navigation aide\|Modèles}}~~

	== #if ==		== #if ==

Aide:ParserFunctions - Historique des versions

Red Bull Salzbourg : rectif des coquilles les plus flagrantes

X-Fusion : X-Fusion a déplacé la page Aide:Extension ParserFunctions vers Aide:ParserFunctions par-dessus une redirection