Navigation interactive dans l’historique

Dernière version du 5 février 2026 à 18:34

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>

@@ 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.
-Si vous n’avez pas encore consulté les bases de la syntaxe, il est recommandé de commencer par la page [[Aide:Syntaxe de base]].
+Cette page regroupe des fonctionnalités avancées de MediaWiki.
+Elles sont utiles pour les cas techniques ou la création de modèles.
-Ces éléments ne sont pas indispensables pour contribuer au wiki.
+Pour les bases de mise en forme, voir → [[Aide:Syntaxe de base]].
-Ils permettent toutefois de gérer des cas plus spécifiques ou techniques.
-= Notes et références =
+Ces éléments ne sont pas nécessaires pour une contribution simple.
-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 :
+---
-<pre><nowiki>Texte avec une note<ref>Détail de la source</ref>
+== Notes et références ==
+Permettent de citer des sources ou d’ajouter des précisions.
+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>
+Règles :
+* 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
-<pre><nowiki>Source<ref name="src">Détail de la source</ref>
+---
-Autre passage<ref name="src" /></nowiki></pre>
-= Redirections et ancres =
+== 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>
-= Fonctions du parseur (ParserFunctions) =
+À utiliser uniquement si une section standard ne suffit pas.
-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.
+---
-== #if — condition simple ==
+== Fonctions du parseur (ParserFunctions) ==
-<pre><nowiki>{{#if:{{{param|}}}|Paramètre présent|Paramètre vide}}</nowiki></pre>
-== #switch — sélection selon une valeur ==
+Utilisées principalement dans les modèles pour gérer des conditions ou calculs.
+=== Condition (#if) ===
+<pre><nowiki>{{#if:{{{param|}}}|Présent|Vide}}</nowiki></pre>
+=== 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 ==
-À écrire :
+Pour afficher du code lisiblement.
+Préférer :
 <pre><nowiki><syntaxhighlight lang="javascript">
 function hello(name){
@@ Ligne 73 : / Ligne 97 : @@
 </syntaxhighlight></nowiki></pre>
-= Galerie avancée =
+Sinon :
-La balise <code>&lt;gallery&gt;</code> accepte différentes options selon la version du wiki.
+<pre><nowiki><pre>Code brut</pre></nowiki></pre>
+---
+== Galerie avancée ==
+Afficher plusieurs images avec options.
-Exemple :
+Syntaxe :
 <pre><nowiki><gallery mode="packed" widths="200" heights="150">
 Fichier:img1.png|Légende 1
@@ Ligne 82 : / Ligne 112 : @@
 </gallery></nowiki></pre>
-= Comportements spéciaux =
+Règle :
-Certaines commandes influencent le comportement global d’une page.
+* utiliser uniquement si plusieurs images sont nécessaires
+---
-À écrire :
+== Comportements spéciaux ==
-<pre><nowiki>__TOC__ <!-- force l’affichage du sommaire -->
-__NOTOC__ <!-- supprime le sommaire -->
+Commandes influençant l’affichage global.
-__HIDDENCAT__ <!-- catégorie masquée (à placer dans la page de catégorie) -->
+Syntaxe :
+<pre><nowiki>__TOC__
+__NOTOC__
+__HIDDENCAT__
 {{DEFAULTSORT:Nom, Prenom}}</nowiki></pre>
-= Bonnes pratiques =
+Usage :
-* Utiliser ces fonctionnalités uniquement en cas de besoin réel.
+* __TOC__ : forcer l’affichage du sommaire
-* Documenter chaque modèle via une sous-page /doc.
+* __NOTOC__ : masquer le sommaire
-* Éviter l’abus de HTML inline lorsque la syntaxe wiki suffit.
+* __HIDDENCAT__ : catégorie masquée (pages de catégories)
-* Garder les exemples lisibles en combinant <code>&lt;pre&gt;</code> et <code>&lt;nowiki&gt;</code>.
+* 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 <code>&lt;pre&gt;</code> et <code>&lt;nowiki&gt;</code>
-[[Catégorie:Aide]]
+[[Catégorie:Aide à la rédaction]]