Aide : Syntaxe avancée

Objectif

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.

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 <ref>. Les notes sont ensuite affichées à l’aide de <references />.

Exemple simple :

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

<references />

Il est également possible de réutiliser une note nommée :

Source<ref name="src">Détail de la source</ref>
Autre passage<ref name="src" />

Redirections et ancres

Redirections

Une redirection permet d’envoyer automatiquement le lecteur vers une autre page.

À écrire :

#REDIRECT [[Page cible]]

Ancres de section

Il est possible de lier directement vers une section d’une page :

[[Page#Nom de section]]

Ancres manuelles

Pour créer une ancre personnalisée :

<span id="origine"></span>
… et lier : [[Page#origine]]

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.

#if — condition simple

{{#if:{{{param|}}}|Paramètre présent|Paramètre vide}}

#switch — sélection selon une valeur

{{#switch: {{{type|}}}
| ville = C’est une ville
| personnage = C’est un personnage
| #default = Type inconnu
}}

#expr — calcul numérique

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

Mise en forme du code (Syntaxhighlight)

Lorsque l’extension est activée, <syntaxhighlight> permet un affichage plus lisible du code. Sinon, il est recommandé de rester sur <pre>.

À écrire :

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

Galerie avancée

La balise <gallery> accepte différentes options selon la version du wiki.

Exemple :

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

Comportements spéciaux

Certaines commandes influencent le comportement global d’une page.

À écrire :

__TOC__ <!-- force l’affichage du sommaire -->
__NOTOC__ <!-- supprime le sommaire -->
__HIDDENCAT__ <!-- catégorie masquée (à placer dans la page de catégorie) -->
{{DEFAULTSORT:Nom, Prenom}}

Bonnes pratiques

Utiliser ces fonctionnalités uniquement en cas de besoin réel.
Documenter chaque modèle via une sous-page /doc.
Éviter l’abus de HTML inline lorsque la syntaxe wiki suffit.
Garder les exemples lisibles en combinant <pre> et <nowiki>.