Basculer le menu
Changer de menu des préférences
Basculer le menu personnel
Non connecté(e)
Votre adresse IP sera visible au public si vous faites des modifications.

« Aide:Syntaxe avancée » : différence entre les versions

Fonctionnalités avancées de la syntaxe MediaWiki pour gérer références, redirections, modèles et comportements spéciaux.
Aucun résumé des modifications
Agrado (discussion | contributions)
Aucun résumé des modifications
 
(4 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
= Aide : Syntaxe avancée =
{{SHORTDESC:Fonctionnalités avancées de la syntaxe MediaWiki pour gérer références, redirections, modèles et comportements spéciaux.}}
<references/></nowiki></pre>


__TOC__
= 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 :
<pre><nowiki>Texte avec note<ref>Détail de la source</ref>
<references /></nowiki></pre>


Réutiliser une note nommée :
Réutiliser une note nommée :
<pre><nowiki>Source<ref name="src">Détail de la source</ref>
<pre><nowiki><ref name="src">Source</ref>
Autre passage<ref name="src"/></nowiki></pre>
<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
 
---
 
== Redirections et ancres ==


=== Redirection ===
Redirige automatiquement vers une autre page.


== Redirections & ancres ==
Syntaxe :
Créer une **redirection** :
<pre><nowiki>#REDIRECT [[Page cible]]</nowiki></pre>
<pre><nowiki>#REDIRECT [[Page cible]]</nowiki></pre>


Règle :
* une seule ligne, seule dans la page


Lier vers une **ancre de section** :
---
 
=== Lien vers une section ===
Syntaxe :
<pre><nowiki>[[Page#Nom de section]]</nowiki></pre>
<pre><nowiki>[[Page#Nom de section]]</nowiki></pre>


---
=== Ancre manuelle ===
Créer un point d’ancrage personnalisé.


Créer une **ancre manuelle** :
Syntaxe :
<pre><nowiki><span id="origine"></span>
<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) ==
== Fonctions du parseur (ParserFunctions) ==
Nécessitent l’extension appropriée. Exemples :


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>


 
=== Sélection (#switch) ===
#switch — sélection selon une valeur :
<pre><nowiki>{{#switch: {{{type|}}}
<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>
}}</nowiki></pre>


=== Calcul (#expr) ===
<pre><nowiki>{{#expr: (10 + 2) * 3 }}</nowiki></pre>


#expr — calcul numérique :
Règles :
<pre><nowiki>{{#expr: (10 + 2) * 3 }}</nowiki></pre>
* réserver ces fonctions aux modèles
* éviter la logique complexe dans les pages simples


---


== Syntaxhighlight (si activé) ==
== Mise en forme du code ==
Mieux que <pre> pour le code ; sinon, rester sur <pre>.


Pour afficher du code lisiblement.


À écrire :
Préférer :
<pre><nowiki><syntaxhighlight lang="javascript">
<pre><nowiki><syntaxhighlight lang="javascript">
function hello(name){
function hello(name){
return `Bonjour ${name}`;
  return `Bonjour ${name}`;
}
}
</syntaxhighlight></nowiki></pre>
</syntaxhighlight></nowiki></pre>


Sinon :
<pre><nowiki><pre>Code brut</pre></nowiki></pre>
---


== Galerie avancée ==
== Galerie avancée ==
Options possibles (selon version) : mode, largeurs, légendes.


Afficher plusieurs images avec options.


À écrire :
Syntaxe :
<pre><nowiki><gallery mode="packed" widths="200" heights="150">
<pre><nowiki><gallery mode="packed" widths="200" heights="150">
Fichier:img1.png|Légende 1
Fichier:img1.png|Légende 1
Ligne 64 : Ligne 112 :
</gallery></nowiki></pre>
</gallery></nowiki></pre>


Règle :
* utiliser uniquement si plusieurs images sont nécessaires
---


== Comportements spéciaux ==
== Comportements spéciaux ==
Insérer/supprimer table des matières, cacher une catégorie, tri par défaut :


Commandes influençant l’affichage global.


À écrire :
Syntaxe :
<pre><nowiki>__TOC__ <!-- force l’affichage du sommaire -->
<pre><nowiki>__TOC__
__NOTOC__ <!-- supprime le sommaire -->
__NOTOC__
__HIDDENCAT__ <!-- catégorie masquée (à mettre dans la page de catégorie) -->
__HIDDENCAT__
{{DEFAULTSORT:Nom, Prenom}}</nowiki></pre>
{{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 ==
== Bonnes pratiques ==
* Documenter chaque modèle via une sous-page /doc.
* utiliser ces fonctionnalités uniquement en cas de besoin réel
* Ne pas abuser des HTML inline si une syntaxe wiki existe.
* privilégier la syntaxe wiki au HTML
* Garder les exemples lisibles en combinant <pre> + <nowiki>.
* 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]]

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>
Les témoins (''cookies'') nous aident à fournir nos services. En utilisant nos services, vous acceptez notre utilisation de témoins.