Version du 5 février 2026 à 18:11

Syntaxe MediaWiki – avancée

Cette page regroupe des fonctionnalités avancées de MediaWiki. Elles sont utiles pour les cas techniques ou la création de modèles.

Pour les bases de mise en forme, voir → Aide:Syntaxe de base.

Ces éléments ne sont pas nécessaires pour une contribution simple.

---

Notes et références

Permettent de citer des sources ou d’ajouter des précisions.

Syntaxe :

Texte avec note<ref>Détail de la source</ref>

<references />

Réutiliser une note nommée :

<ref name="src">Source</ref>
<ref name="src" />

Règles :

placer <references /> en fin de page ou dans une section dédiée
nommer les références réutilisées

---

Redirections et ancres

Redirection

Redirige automatiquement vers une autre page.

Syntaxe :

#REDIRECT [[Page cible]]

Règle :

une seule ligne, seule dans la page

---

Lien vers une section

Syntaxe :

[[Page#Nom de section]]

---

Ancre manuelle

Créer un point d’ancrage personnalisé.

Syntaxe :

<span id="origine"></span>
[[Page#origine]]

À utiliser uniquement si une section standard ne suffit pas.

---

Fonctions du parseur (ParserFunctions)

Utilisées principalement dans les modèles pour gérer des conditions ou calculs.

Condition (#if)

{{#if:{{{param|}}}|Présent|Vide}}

Sélection (#switch)

{{#switch: {{{type|}}}
| ville = Ville
| personnage = Personnage
| #default = Inconnu
}}

Calcul (#expr)

{{#expr: (10 + 2) * 3 }}

Règles :

réserver ces fonctions aux modèles
éviter la logique complexe dans les pages simples

---

Mise en forme du code

Pour afficher du code lisiblement.

Préférer :

<syntaxhighlight lang="javascript">
function hello(name){
  return `Bonjour ${name}`;
}
</syntaxhighlight>

Sinon :

<nowiki><pre>Code brut

</nowiki>

---

Galerie avancée

Afficher plusieurs images avec options.

Syntaxe :

<gallery mode="packed" widths="200" heights="150">
Fichier:img1.png|Légende 1
Fichier:img2.png|Légende 2
</gallery>

Règle :

utiliser uniquement si plusieurs images sont nécessaires

---

Comportements spéciaux

Commandes influençant l’affichage global.

Syntaxe :

__TOC__
__NOTOC__
__HIDDENCAT__
{{DEFAULTSORT:Nom, Prenom}}

Usage :

: forcer l’affichage du sommaire
: masquer le sommaire
: catégorie masquée (pages de catégories)
DEFAULTSORT : clé de tri

---

Bonnes pratiques

utiliser ces fonctionnalités uniquement en cas de besoin réel
privilégier la syntaxe wiki au HTML
garder les modèles simples et documentés (/doc)
commenter le code complexe
conserver des exemples lisibles avec <pre> et <nowiki>

---

Voir aussi

@@ Ligne 1 : / Ligne 1 : @@
+{{SHORTDESC:Fonctionnalités avancées de la syntaxe MediaWiki pour gérer références, redirections, modèles et comportements spéciaux.}}
 __TOC__
-== Objectif ==
+= Syntaxe MediaWiki – avancée =
-Cette page présente des fonctionnalités avancées de la syntaxe MediaWiki.
-Elle s’adresse aux contributeurs déjà à l’aise avec les bases et souhaitant aller plus loin dans la structuration ou l’optimisation des pages.
+Cette page regroupe des fonctionnalités avancées de MediaWiki.
+Elles sont utiles pour les cas techniques ou la création de modèles.
+Pour les bases de mise en forme, voir → [[Aide:Syntaxe de base]].
-Si vous n’avez pas encore consulté les bases de la syntaxe, il est recommandé de commencer par la page [[Aide:Syntaxe de base]].
+Ces éléments ne sont pas nécessaires pour une contribution simple.
-Ces éléments ne sont pas indispensables pour contribuer au wiki.
+---
-Ils permettent toutefois de gérer des cas plus spécifiques ou techniques.
 == Notes et références ==
-Il est possible d’ajouter des notes à un article à l’aide de la balise <code>&lt;ref&gt;</code>.
-Les notes sont ensuite affichées à l’aide de <code>&lt;references /&gt;</code>.
-Exemple simple :
+Permettent de citer des sources ou d’ajouter des précisions.
-<pre><nowiki>Texte avec une note<ref>Détail de la source</ref>
+Syntaxe :
+<pre><nowiki>Texte avec note<ref>Détail de la source</ref>
 <references /></nowiki></pre>
-Il est également possible de réutiliser une note nommée :
+Réutiliser une note nommée :
+<pre><nowiki><ref name="src">Source</ref>
+<ref name="src" /></nowiki></pre>
-<pre><nowiki>Source<ref name="src">Détail de la source</ref>
+Règles :
-Autre passage<ref name="src" /></nowiki></pre>
+* placer <code>&lt;references /&gt;</code> en fin de page ou dans une section dédiée
+* nommer les références réutilisées
+---
 == Redirections et ancres ==
-=== Redirections ===
+=== Redirection ===
-Une redirection permet d’envoyer automatiquement le lecteur vers une autre page.
+Redirige automatiquement vers une autre page.
-À écrire :
+Syntaxe :
 <pre><nowiki>#REDIRECT [[Page cible]]</nowiki></pre>
-=== Ancres de section ===
+Règle :
-Il est possible de lier directement vers une section d’une page :
+* une seule ligne, seule dans la page
+---
+=== Lien vers une section ===
+Syntaxe :
 <pre><nowiki>[[Page#Nom de section]]</nowiki></pre>
-=== Ancres manuelles ===
+---
-Pour créer une ancre personnalisée :
+=== Ancre manuelle ===
+Créer un point d’ancrage personnalisé.
+Syntaxe :
 <pre><nowiki><span id="origine"></span>
-… et lier : [[Page#origine]]</nowiki></pre>
+[[Page#origine]]</nowiki></pre>
+À utiliser uniquement si une section standard ne suffit pas.
+---
 == Fonctions du parseur (ParserFunctions) ==
-Les fonctions du parseur permettent d’introduire des conditions ou des calculs simples.
-Elles nécessitent que l’extension correspondante soit activée sur le wiki.
-Ces fonctions sont surtout utilisées dans les modèles.
+Utilisées principalement dans les modèles pour gérer des conditions ou calculs.
-=== #if — condition simple ===
+=== Condition (#if) ===
-<pre><nowiki>{{#if:{{{param|}}}|Paramètre présent|Paramètre vide}}</nowiki></pre>
+<pre><nowiki>{{#if:{{{param|}}}|Présent|Vide}}</nowiki></pre>
-=== #switch — sélection selon une valeur ===
+=== Sélection (#switch) ===
 <pre><nowiki>{{#switch: {{{type|}}}
-| ville = C’est une ville
+| ville = Ville
-| personnage = C’est un personnage
+| personnage = Personnage
-| #default = Type inconnu
+| #default = Inconnu
 }}</nowiki></pre>
-=== #expr — calcul numérique ===
+=== Calcul (#expr) ===
 <pre><nowiki>{{#expr: (10 + 2) * 3 }}</nowiki></pre>
-== Mise en forme du code (Syntaxhighlight) ==
+Règles :
-Lorsque l’extension est activée, <code>&lt;syntaxhighlight&gt;</code> permet un affichage plus lisible du code.
+* réserver ces fonctions aux modèles
-Sinon, il est recommandé de rester sur <code>&lt;pre&gt;</code>.
+* éviter la logique complexe dans les pages simples
+---
+== Mise en forme du code ==
+Pour afficher du code lisiblement.
-À écrire :
+Préférer :
 <pre><nowiki><syntaxhighlight lang="javascript">
 function hello(name){
@@ Ligne 72 : / Ligne 96 : @@
 }
 </syntaxhighlight></nowiki></pre>
+Sinon :
+<pre><nowiki><pre>Code brut</pre></nowiki></pre>
+---
 == Galerie avancée ==
-La balise <code>&lt;gallery&gt;</code> accepte différentes options selon la version du wiki.
-Exemple :
+Afficher plusieurs images avec options.
+Syntaxe :
 <pre><nowiki><gallery mode="packed" widths="200" heights="150">
 Fichier:img1.png|Légende 1
 Fichier:img2.png|Légende 2
 </gallery></nowiki></pre>
+Règle :
+* utiliser uniquement si plusieurs images sont nécessaires
+---
 == Comportements spéciaux ==
-Certaines commandes influencent le comportement global d’une page.
-À écrire :
+Commandes influençant l’affichage global.
-<pre><nowiki>__TOC__ <!-- force l’affichage du sommaire -->
-__NOTOC__ <!-- supprime le sommaire -->
+Syntaxe :
-__HIDDENCAT__ <!-- catégorie masquée (à placer dans la page de catégorie) -->
+<pre><nowiki>__TOC__
+__NOTOC__
+__HIDDENCAT__
 {{DEFAULTSORT:Nom, Prenom}}</nowiki></pre>
+Usage :
+* __TOC__ : forcer l’affichage du sommaire
+* __NOTOC__ : masquer le sommaire
+* __HIDDENCAT__ : catégorie masquée (pages de catégories)
+* DEFAULTSORT : clé de tri
+---
 == Bonnes pratiques ==
-* Utiliser ces fonctionnalités uniquement en cas de besoin réel.
+* utiliser ces fonctionnalités uniquement en cas de besoin réel
-* Documenter chaque modèle via une sous-page /doc.
+* privilégier la syntaxe wiki au HTML
-* Éviter l’abus de HTML inline lorsque la syntaxe wiki suffit.
+* garder les modèles simples et documentés (/doc)
-* Garder les exemples lisibles en combinant <code>&lt;pre&gt;</code> et <code>&lt;nowiki&gt;</code>.
+* commenter le code complexe
+* conserver des exemples lisibles avec <code>&lt;pre&gt;</code> et <code>&lt;nowiki&gt;</code>
+---
+== Voir aussi ==
+* [[Aide:Contribuer]]
+* [[Aide:Rédaction]]
+* [[Aide:Syntaxe de base]]
+* [[Convention de style]]
-[[Catégorie:Aide]]
+[[Catégorie:Aide à la rédaction]]