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 générales :


 * 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 renvoient des informations à propos de la page courante, du wiki ou de la date. Leur syntaxe est similaire à celle des modèles. Les variables indiquées par « [coûteux] » sont comptées par le logiciel et le nombre de ces variables pouvant ê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, il faudra écrire ). Dans certains cas, des paramètres additionnels, forceront l'analyseur à transclure le modèle. Par exemple, $tpl-currentdayname-code transclut $tpl-currentdayname-result, 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.

L'utilisation de ces variables fait que les pages sont mises en cache pour un nombre plus limité de secondes. Ceci est paramètré dans MagicWordFactory.

Les mots magiques d’horodatage sont formatés dans la langue du contenu du wiki. Depuis, ils sont fonction de 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 des formats supplémentaires du 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 .



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 $nop-code &rarr; $nop-result et $nop-r-code &rarr; $nop-r-result).

Utilisez « |R » pour les mots magiques qui nécessitent un paramètre tel que PAGESINCATEGORY (par exemple $pic et $pic-r, ou $pic-subcats et $pic-subcats-r). Applicable aussi au dans ce qui précède.

Les mots magiques des nombres sont formatés selon la langue du contenu du wiki. Depuis, cela dépend de 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 renvoyé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:





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. Voir pour plus de 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)

Autres


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.



Métadonnées techniques d'une autre page


Espaces de noms
retourne le nom localisé actuel pour l’espace de noms avec cet indice, ce nom canonique, ou cet alias local. Ainsi,,   et   (un ancien nom de l'espace de noms File) renvoient tous « File ». Sur un wiki où la langue du contenu est le français,  est également valide, mais   (la localisation de « File » en allemand) ne l'est pas.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

est l'équivalent encodé pour les URLs de MediaWiki. C'est la même chose, mais les espaces sont remplacés par des soulignés, rendant ces URLs utilisables dans les liens externes.

Ne confondez pas les espaces de noms localisés avec les espaces de noms personnalisés (spécifiques à chaque wiki).

Formatage
Voir aussi :.

Régionalisation
Voici les mots magiques qui sont les principaux outils de régionalisation utilisés. 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 les sections Date et heure, Formatage et Divers. D’autres mots magiques sont 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.

Divers
Pour la fonction d'analyse syntaxique #invoke, voir Exécution d'un module.