« Aide:Syntaxe avancée » : différence entre les versions
De Nefald
Autres actions
Aucun résumé des modifications |
m mise à jour des niveaux de titre |
||
| (Une version intermédiaire par le même utilisateur non affichée) | |||
| Ligne 1 : | Ligne 1 : | ||
__TOC__ | |||
= 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 <code><ref></code>. | |||
Les notes sont ensuite affichées à l’aide de <code><references /></code>. | |||
Exemple simple : | |||
<pre><nowiki>Texte avec une note<ref>Détail de la source</ref> | |||
<references /></nowiki></pre> | |||
Il est également possible de réutiliser une note nommée : | |||
<pre><nowiki>Source<ref name="src">Détail de la source</ref> | <pre><nowiki>Source<ref name="src">Détail de la source</ref> | ||
Autre passage<ref name="src"/></nowiki></pre> | Autre passage<ref name="src" /></nowiki></pre> | ||
= Redirections et ancres = | |||
== Redirections | == Redirections == | ||
Une redirection permet d’envoyer automatiquement le lecteur vers une autre page. | |||
À écrire : | |||
<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 : | |||
<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 : | |||
<pre><nowiki><span id="origine"></span> | <pre><nowiki><span id="origine"></span> | ||
… 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. | |||
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 — 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 == | |||
#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 37 : | Ligne 59 : | ||
}}</nowiki></pre> | }}</nowiki></pre> | ||
== #expr — calcul numérique == | |||
#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. | |||
Sinon, il est recommandé de rester sur <code><pre></code>. | |||
À écrire : | À écrire : | ||
<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> | ||
= Galerie avancée = | |||
La balise <code><gallery></code> accepte différentes options selon la version du wiki. | |||
Exemple : | |||
<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 82 : | ||
</gallery></nowiki></pre> | </gallery></nowiki></pre> | ||
= Comportements spéciaux = | |||
Certaines commandes influencent le comportement global d’une page. | |||
À écrire : | À écrire : | ||
<pre><nowiki>__TOC__ <!-- force l’affichage du sommaire --> | <pre><nowiki>__TOC__ <!-- force l’affichage du sommaire --> | ||
__NOTOC__ <!-- supprime le sommaire --> | __NOTOC__ <!-- supprime le sommaire --> | ||
__HIDDENCAT__ <!-- catégorie masquée (à | __HIDDENCAT__ <!-- catégorie masquée (à placer dans la page de catégorie) --> | ||
{{DEFAULTSORT:Nom, Prenom}}</nowiki></pre> | {{DEFAULTSORT:Nom, Prenom}}</nowiki></pre> | ||
= Bonnes pratiques = | |||
* 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. | ||
* | * Éviter l’abus de HTML inline lorsque la syntaxe wiki suffit. | ||
* Garder les exemples lisibles en combinant <pre> | * Garder les exemples lisibles en combinant <code><pre></code> et <code><nowiki></code>. | ||
[[Catégorie:Aide]] | [[Catégorie:Aide]] | ||