Manuel des extensions MediaWiki

RegexFunctions État de la version : stableCategory:Stable extensions/fr
Implémentation	Fonction d'analyseur Category:Parser function extensions/fr
Description	Fonctions d'analyse syntaxique basées sur des expressions régulières
Auteur(s)	Ryan Schmidt (Skizzerzdiscussion)
Dernière version	2.0.0 (2020-03-18)
MediaWiki	1.31+Category:Extensions with manual MediaWiki version
Licence	domaine public
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source Category:Extensions in Wikimedia version control/fr Utilisation
Accroches utilisées ParserFirstCallInit Category:ParserFirstCallInit extensions/fr
Téléchargements trimestriels	15 (Ranked 100th)
Traduire l’extension RegexFunctions sur translatewiki.net si elle y est disponible

L'extension RegexFunctions fournit des fonctions d'analyse syntaxique basées sur des expressions régulières.

Utilisation

Actuellement cette extension définit trois fonctions d'analyse : rmatch, rsplit, et rreplace

#rmatch:

{{#rmatch:string|pattern|then|else}}

string (obligatoire) - Le texte que la fonction doit utiliser pour faire la recherche.

pattern (obligatoire) - L'expression régulière à utiliser pour le texte.

then (optionnel) - Ce qu'il faut rendre lorsque le motif a été trouvé. $# et \# contiennent le texte capturé. Utilisez ${#}# si vous désirez qu'un groupe soit suivi par un autre numéro.

else (optionnel) - Ce qu'il faut rendre lorsque le motif a été trouvé. Une chaîne vide par défaut.

#rsplit:

{{#rsplit:string|pattern|piece}}

string (obligatoire) - Le texte que la fonction va analyser.

pattern (obligatoire) - Expression régulière à utiliser pour le texte. Pas de correspondance trouvée.

piece (optionnel) - Pièce à retourner. 0 par défault (qui correspond à la première pièce). Les nombres négatifs rendent les pièces en commençant à partir de la fin. Par exemple -1 est la dernière pièce.

#rreplace:

{{#rreplace:string|pattern|replacement}}

string (obligatoire) - Le texte que la fonction va remplacer.

pattern (obligatoire) - Expression régulière à utiliser sur le texte.

replacement (obligatoire) - Texte qui remplacera le texte détecté. $# et \# contiennent le texte capturé. Utilisez ${#}# si vous désirez qu'un groupe soit suivi par un autre numéro.

Sauf pour le paramètre string, chaque paramètre peut être spécifié soit par son nom, soit par sa position. Par exemple, {{#rmatch:some string|pattern=^.+$|then=success|else=failure}}. Si la langue du contenu de votre wiki n'est pas l'anglais, vous pouvez utiliser à la fois les noms anglais ainsi que les noms traduits. De plus chaque fonction prend en charge les paramètres nommés suivants qui vous permettent de modifier le comportement de l'expression régulière :

• multiline - Si non vide alors ^ et $ correspondent chacuns au début et à la fin de chaque ligne, plutôt qu'au début et à la fin de la chaîne complète.
• caseless - Si non vide alors le motif s'applique quelque soit la casse.
• ungreedy - Si non vide, * et + sont assez restrictifs tandis que *? et +? sont beaucoup moins sélectifs.
• extended - Si non vide, l'espression régulière peut contenir des espaces et des commentaires en ligne. Pour plus d'information, voir la section d'aide sur les motifs, dans la documentation PHP.
• dotall - Si non vide, . correspond à tous les caractères y compris les passages à la ligne. Habituellement, il ne détecte pas ces derniers.

Par exemple, {{#rmatch:XxXxX|x+|$0|caseless=1}} va produire en sortie XxXxX parce que x+ correspond à la fois aux X en majuscules et en minuscules lorsque le modificateur pour ignorer la casse est positionné.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé RegexFunctions dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RegexFunctions
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'RegexFunctions' );
  

• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Voir aussi

• ReplaceSet - un excellent substitut pour l'utilisation des commandes #replace imbriquées lorsque vous avez besoin de réaliser une séquence de remplacement sur une seule chaîne de texte.
• Regex Fun - juste une extension regex supplémentaire avec davantage de fonctionnalités mais sans variables personnalisables pour les limitations.
• MassEditRegex

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : MyWikisCategory:Extensions included in MyWikis/fr ProWikiCategory:Extensions included in ProWiki/fr wiki.gg Category:Extensions included in wiki.gg/fr WikiForgeCategory:Extensions included in WikiForge/fr Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer.