Help:Magic words/fr

Les mots magiques sont des chaînes textuelles que MediaWiki associe à une valeur ou à une fonction, comme l’heure, des détails sur le site ou un nom de page. Cette page concerne seulement l’utilisation des mots magiques standards ; pour une référence technique, consulter

Les mots magiques se répartissent en trois catégories :


 * Sélecteurs de comportement : ils sont habituellement écrits en capitales et entourés de doubles caractères de soulignement, par exemple  .


 * Variables : ce sont des mots écrits en capitales et encadrés de doubles accolades, par ex. :  . Sous cette forme ils ressemblent vraiment aux modèles.


 * Fonctions d'analyse : ces fonctions prennent des paramètres et sont soit de la forme   soit de la forme  , par exemple . Voir aussi  et.

Les variables et les fonctions de l'analyseur peuvent fonctionner avec subst:, tout comme les modèles. Les pages qui utilisent ces mots magiques seront affectées ou retourneront la page en cours (par défaut), et ce même si le mot est ajouté via un modèle transclus ou un message système inclus.

Les sélecteurs de comportement
Un sélecteur de comportement contrôle l’architecture ou le comportement de la page (si l’habillage le prend en charge), et peut tout aussi bien être utilisé pour spécifier des omissions volontaires et des inclusions dans le contenu. Notamment certains de ces comportements ne sont pas pris en charge par l’habillage Minerva.

Variables
Les variables retournent des informations à propos de la page courante, du wiki ou de la date. Leur syntaxe est similaire à ces modèles. Les variables indiquées par « [expensive] » sont comptées par le logiciel, et le nombre de ces variables qui peuvent être incluses dans la page est limité.

S’il existe un conflit entre le nom d’un modèle et une variable, c’est la variable qui sera utilisée (donc pour transcoder le modèle    :PAGENAME, il faudra écrire  ). Dans certains cas, des paramètres additionnels, forceront l'analyseur à transclure le modèle. Par exemple,  transcode     :CURRENTDAYNAME, et « non pas » la variable.

Date et heure
Les variables suivantes renvoient l’heure et la date actuelles en temps universel (UTC).

À cause des caches présents sur le serveur MediaWiki et dans le navigateur, ces variables affichent fréquemment la date et l’heure de la « capture » de la page plutôt que la date actuelle.

Les mots magiques d’horodatage sont formatés dans la langue du contenu du wiki; depuis, ils se basent sur la langue du contenu des pages.

Les variables suivantes font exactement la même chose que les précédentes mais en utilisant la configuration du serveur du site ou.



Pour disposer de formats supplémentaires de temps, ou pour afficher l’année actuelle et la semaine avec une meilleure conformité avec la norme ISO 8601, vous voudrez peut-être installer pour utiliser la fonction d’analyse syntaxique #time.

Métadonnées techniques
Note : les variables de révisions renvoient des données à propos de la dernière modification de la page actuelle, même si on regarde une ancienne version de la page.

Statistiques
Les nombres rendus par ces variables contiennent généralement des séparateurs (virgules, points ou espaces, dépendant de la langue configurée) mais peuvent aussi renvoyer des nombres bruts avec le marqueur ":R" (par exemple  &rarr;  et   &rarr; ).

Utiliser "|R" pour les mots magiques exigeant un paramètre tel que PAGESINCATEGORY (par exemple  et , ou   et  ). S'applique également à  ci-dessus.

Les mots magiques de nombres sont formatés selon la langue du contenu du wiki ou, depuis, selon la langue du contenu de la page.

Noms de page
Aucun de ceux-ci n'est concerné par les modifications du titre affiché en utilisant ; les valeurs retournées sont le titre de la page originale.

Les mots magiques  et   ne fonctionnent que dans les espaces de noms pour lesquels la possibilité de gérer des sous-pages est activée. Pour plus d'information concernant l'activation des sous-pages, voyez.

Depuis 1.15+, tous ces mots magiques acceptent un paramètre pour spécifier une page autre que la page courante:
 * &rarr; 

{{Warning|1=Les titres de pages contenant certains caractères, par exemple des apostrophes  ou astérisques , peuvent produire des résultats inattendus lorsqu'ils sont manipulés au moyen de ces mots magiques, par exemple. Voir les bogues T16779, T18474, T37628, T37746. Un moyen simple de contourner ce risque est d'emballer le nom de page dans  de l'extension ParserFunctions.

Par exemple, si le nom de la page est « $pagename », le code suivant produira la chaîne « $result » :

Noms de pages encodés comme URLs
Les mots magiques suivants sont les équivalents aux précédents mais encodés pour usage dans les URLs MediaWiki (c'est-à-dire que les espaces y sont remplacés par des caractères de soulignement et de certains caractères HTML échappés utilisant l'encodage de caractères numériques) :



Notez que,   et   sont mis en oeuvre de façons distinctes. Voyez Manual:PAGENAMEE encoding pour les détails.

Espaces de noms
Les mots magiques suivants sont équivalents aux précédents mais encodés pour usage dans les URLs MediaWiki (les espaces y sont remplacés par des caractères de soulignement et certains caractères par leur encodage en pourcentage):



Depuis 1.15+, ils acceptent un nom de page complet en paramètre et retournent l'espace de noms associé à cette page plutôt que celui associé à la page courante :

Le paramètre ne peut pas être un nom d'espace de noms :
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Fonctions d'analyse
Les fonctions d'analyseur (Parser functions) sont similaires aux variables, mais utilisent un ou plusieurs paramètres (techniquement, tout mot magique qui utilise un paramètre est une fonction de parseur), et leur nom est parfois préfixé par un croisillon pour le différentier des modèles.

Cette page décrit les fonctions de parseur qui sont partie intégrante du logiciel MediaWiki. D'autres fonctions de parseur peuvent être ajoutées via des extensions MediaWiki comme. Pour cela, voyez.

Espaces de noms
retourne le nom localisé actuel pour l’espace de noms avec cet indice, ce nom canonique, ou cet alias local. Ansi,  , et   (un ancien nom pour l’espace de noms Fichier) retournent tous «      ». Sur un wiki dont la langue de contenu est le français,  est également valide, mais   (la traduction de « Fichier » en allemand) ne l’est pas.

est l'équivalent encodé pour les URL de MediaWiki. C'est équivalent, mais les espaces sont remplacés par des soulignés, rendant ces URL utilisables en tant que lien externe.

Ne confondez pas les espaces de noms localisés avec les espaces de noms des utilisateurs.

Formatage
Voir aussi :.

Internationalisation
Voici les mots magiques qui sont utilisés comme outils de localisation principaux. Les autres mots magiques dépendront souvent de la régionalisation du wiki et de la configuration ou bien de la langue choisie : voir en particulier #Date and time, #Formatting, #Miscellaneous. Davantage de mots magiques seront ajoutés par.

L'emploi de ces mots magiques peut être très complexe, et la documentation est actuellement incomplète; pour plus d'information voir les liens suivants : PLURIEL, GRAMMAIRE, GENRE.

Modificateurs de transclusion
Habituellement,  transclut une autre page, par défaut une page de l'espace de noms Modèle:. Ces mots magiques modifient ce comportement.