« Aide:Syntaxe avancée » : différence entre les versions
De Nefald
Autres actions
Aucun résumé des modifications |
m re-correction des titres :( |
||
| (2 versions intermédiaires par le même utilisateur non affichées) | |||
| 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) == | == 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) == | |||
== 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 == | == 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 | ||
Fichier:img2.png|Légende 2 | Fichier:img2.png|Légende 2 | ||
</gallery></nowiki></pre> | </gallery></nowiki></pre> | ||
== Comportements spéciaux == | == 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 == | == 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]] | ||