« Aide:Syntaxe avancée » : différence entre les versions
De Nefald
Autres actions
Refonte de la page - version plus didactique |
m mise à jour des niveaux de titre |
||
| Ligne 1 : | Ligne 1 : | ||
__TOC__ | __TOC__ | ||
= Objectif = | |||
Cette page présente des fonctionnalités avancées de la syntaxe MediaWiki. | 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. | 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. | ||
| Ligne 11 : | Ligne 10 : | ||
Ils permettent toutefois de gérer des cas plus spécifiques ou techniques. | 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><ref></code>. | Il est possible d’ajouter des notes à un article à l’aide de la balise <code><ref></code>. | ||
Les notes sont ensuite affichées à l’aide de <code><references /></code>. | Les notes sont ensuite affichées à l’aide de <code><references /></code>. | ||
| Ligne 25 : | Ligne 24 : | ||
Autre passage<ref name="src" /></nowiki></pre> | Autre passage<ref name="src" /></nowiki></pre> | ||
= Redirections et ancres = | |||
== Redirections == | |||
Une redirection permet d’envoyer automatiquement le lecteur vers une autre page. | Une redirection permet d’envoyer automatiquement le lecteur vers une autre page. | ||
| Ligne 33 : | Ligne 32 : | ||
<pre><nowiki>#REDIRECT [[Page cible]]</nowiki></pre> | <pre><nowiki>#REDIRECT [[Page cible]]</nowiki></pre> | ||
== Ancres de section == | |||
Il est possible de lier directement vers une section d’une page : | Il est possible de lier directement vers une section d’une page : | ||
<pre><nowiki>[[Page#Nom de section]]</nowiki></pre> | <pre><nowiki>[[Page#Nom de section]]</nowiki></pre> | ||
== Ancres manuelles == | |||
Pour créer une ancre personnalisée : | Pour créer une ancre personnalisée : | ||
| Ligne 44 : | Ligne 43 : | ||
… et lier : [[Page#origine]]</nowiki></pre> | … et lier : [[Page#origine]]</nowiki></pre> | ||
= Fonctions du parseur (ParserFunctions) = | |||
Les fonctions du parseur permettent d’introduire des conditions ou des calculs simples. | 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. | Elles nécessitent que l’extension correspondante soit activée sur le wiki. | ||
| Ligne 50 : | Ligne 49 : | ||
Ces fonctions sont surtout utilisées dans les modèles. | Ces fonctions sont surtout utilisées dans les modèles. | ||
== #if — condition simple == | |||
<pre><nowiki>{{#if:{{{param|}}}|Paramètre présent|Paramètre vide}}</nowiki></pre> | <pre><nowiki>{{#if:{{{param|}}}|Paramètre présent|Paramètre vide}}</nowiki></pre> | ||
== #switch — sélection selon une valeur == | |||
<pre><nowiki>{{#switch: {{{type|}}} | <pre><nowiki>{{#switch: {{{type|}}} | ||
| ville = C’est une ville | | ville = C’est une ville | ||
| Ligne 60 : | Ligne 59 : | ||
}}</nowiki></pre> | }}</nowiki></pre> | ||
== #expr — calcul numérique == | |||
<pre><nowiki>{{#expr: (10 + 2) * 3 }}</nowiki></pre> | <pre><nowiki>{{#expr: (10 + 2) * 3 }}</nowiki></pre> | ||
= Mise en forme du code (Syntaxhighlight) = | |||
Lorsque l’extension est activée, <code><syntaxhighlight></code> permet un affichage plus lisible du code. | Lorsque l’extension est activée, <code><syntaxhighlight></code> permet un affichage plus lisible du code. | ||
Sinon, il est recommandé de rester sur <code><pre></code>. | Sinon, il est recommandé de rester sur <code><pre></code>. | ||
| Ligne 74 : | Ligne 73 : | ||
</syntaxhighlight></nowiki></pre> | </syntaxhighlight></nowiki></pre> | ||
= Galerie avancée = | |||
La balise <code><gallery></code> accepte différentes options selon la version du wiki. | La balise <code><gallery></code> accepte différentes options selon la version du wiki. | ||
| Ligne 83 : | Ligne 82 : | ||
</gallery></nowiki></pre> | </gallery></nowiki></pre> | ||
= Comportements spéciaux = | |||
Certaines commandes influencent le comportement global d’une page. | Certaines commandes influencent le comportement global d’une page. | ||
| Ligne 92 : | Ligne 91 : | ||
{{DEFAULTSORT:Nom, Prenom}}</nowiki></pre> | {{DEFAULTSORT:Nom, Prenom}}</nowiki></pre> | ||
= 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. | * Documenter chaque modèle via une sous-page /doc. | ||
Version du 3 février 2026 à 21:37
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>.