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 de base » : différence entre les versions

Bases essentielles de la syntaxe MediaWiki pour structurer et mettre en forme une page du wiki de Nefald.
Agrado (discussion | contributions)
m mise à jour des niveaux de titre
Agrado (discussion | contributions)
mAucun résumé des modifications
 
(2 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
{{SHORTDESC:Bases essentielles de la syntaxe MediaWiki pour structurer et mettre en forme une page du wiki de Nefald.}}
__TOC__
__TOC__


= Objectif =
= Syntaxe MediaWiki – bases =
Cette page présente les bases de la syntaxe MediaWiki utilisée sur le wiki de Nefald.
Elle s’adresse aux contributeurs débutants qui souhaitent comprendre comment structurer et mettre en forme un article.


Les exemples sont volontairement simples et affichés en code non interprété.
Cette page présente les éléments essentiels de la syntaxe MediaWiki utilisés sur le wiki de Nefald.


Si vous êtes déjà à l’aise avec la syntaxe MediaWiki ou si vous avez déjà parcouru cette page, vous pouvez vous rendre directement sur la page [[Aide:Syntaxe avancée]].
Elle couvre la mise en forme simple.
Pour des cas plus complexes, voir → [[Aide:Syntaxe avancée]].


= Sauts de ligne et paragraphes =
---
Dans MediaWiki, un simple retour à la ligne ne crée pas un nouveau paragraphe.


Règles à retenir :
== Paragraphes et sauts de ligne ==
* laisser une ligne vide pour créer un nouveau paragraphe,
* utiliser la balise <code>&lt;br&gt;</code> uniquement pour forcer un saut de ligne à l’intérieur d’un paragraphe.


À écrire :
Un simple retour à la ligne ne crée pas de nouveau paragraphe.
 
Règles :
* laisser une ligne vide pour séparer deux paragraphes
* utiliser <code>&lt;br&gt;</code> uniquement pour un saut de ligne interne
 
Exemple :
<pre><nowiki>Ligne 1 sans saut
<pre><nowiki>Ligne 1 sans saut
Ligne 2 (même paragraphe)
Ligne 2 (même paragraphe)
Ligne 24 : Ligne 28 :
Ligne 1<br>Ligne 2 après saut manuel</nowiki></pre>
Ligne 1<br>Ligne 2 après saut manuel</nowiki></pre>


= Titres =
---
Les titres permettent de structurer une page et de générer automatiquement la table des matières.
 
== Titres ==
 
Les titres structurent la page et génèrent la table des matières.
 
Syntaxe :
<pre><nowiki>= Niveau 1 =
== Niveau 2 ==
=== Niveau 3 ===
==== Niveau 4 ====</nowiki></pre>


Ils existent sur plusieurs niveaux, de 1 à 6, et utilisent le caractère <code>=</code>.
Règles :
* un seul niveau 1 par page
* hiérarchie logique
* ne pas sauter de niveau


À écrire :
---
<pre><nowiki>= Titre de niveau 1 =
== Titre de niveau 2 ==
=== Titre de niveau 3 ===
==== Titre de niveau 4 ====</nowiki></pre>


Bonnes pratiques :
== Gras et italique ==
* un seul titre de niveau 1 par page,
* ne pas sauter de niveau (éviter de passer de 2 à 4).


= Gras et italique =
Utiliser la syntaxe wiki plutôt que le HTML.
MediaWiki dispose de sa propre syntaxe pour le gras et l’italique.
Elle est à privilégier par rapport aux balises HTML, sauf cas particulier.


À écrire :
Syntaxe :
<pre><nowiki>''italique''
<pre><nowiki>''italique''
'''gras'''
'''gras'''
'''''gras et italique'''''
'''''gras et italique'''''</nowiki></pre>
<b>gras (HTML)</b> et <i>italique (HTML)</i></nowiki></pre>


= Listes =
Éviter :
Les listes permettent d’organiser des informations de manière claire.
<pre><nowiki><b>gras</b> <i>italique</i></nowiki></pre>


Types de listes :
---
* listes à puces avec <code>*</code>,
* listes numérotées avec <code>#</code>.


L’indentation se fait en répétant le symbole.
== Listes ==


À écrire :
Les listes améliorent la lisibilité.
 
Syntaxe :
<pre><nowiki>* Élément
<pre><nowiki>* Élément
* Élément
* Élément
Ligne 66 : Ligne 73 :
## Sous-élément 2.1</nowiki></pre>
## Sous-élément 2.1</nowiki></pre>


= Liens =
Règles :
Les liens permettent de relier les pages entre elles ou vers des ressources externes.
* utiliser des listes pour les énumérations
* conserver une structure cohérente
 
---
 
== Liens ==
 
Les liens internes facilitent la navigation.
 
Syntaxe :
<pre><nowiki>[[Page]]
[[Page|Texte affiché]]
[https://exemple.tld Texte affiché]</nowiki></pre>
 
Bonnes pratiques :
* lier le premier terme important
* éviter les liens répétés
* privilégier les liens internes
 
---
 
== Commentaires (invisibles) ==
 
Permettent d’ajouter des notes internes non affichées.
 
Syntaxe :
<pre><nowiki>Texte visible <!-- Commentaire invisible --></nowiki></pre>
 
---
 
== Ligne horizontale ==


Types de liens :
Séparation visuelle simple.
* liens internes : <code>[[Page]]</code> ou <code>[[Page|Texte affiché]]</code>,
* liens externes : <code>[https://exemple.tld Texte affiché]</code>.


À écrire :
Syntaxe :
<pre><nowiki>[[Alderheim]]
<pre><nowiki>----</nowiki></pre>
[[Alderheim|capitale]]
[https://wiki.nefald.fr Page d’accueil du wiki]
[[Alderheim#Histoire|Section Histoire]]</nowiki></pre>


= Commentaires (non affichés) =
À utiliser avec parcimonie.
Il est possible d’ajouter des commentaires invisibles pour le lecteur.
Ils sont utiles pour laisser des notes internes.


À écrire :
---
<pre><nowiki>Texte visible <!-- Ceci ne s’affiche pas --></nowiki></pre>


= Lignes horizontales =
== Citations ==
Une ligne horizontale permet de marquer une séparation visuelle dans une page.


Elle s’obtient avec quatre tirets seuls sur une ligne.
Deux méthodes courantes :


À écrire :
Syntaxe :
<pre><nowiki>Texte avant
<pre><nowiki>: Texte cité
----
<blockquote>Bloc de citation</blockquote></nowiki></pre>
Texte après</nowiki></pre>


= Citations =
---
Pour citer un texte, deux méthodes simples existent :


* l’indentation avec <code>:</code>,
== Code et texte non interprété ==
* la balise <code>&lt;blockquote&gt;</code> pour un bloc de citation.


À écrire :
Pour afficher du code ou empêcher l’interprétation wiki :
<pre><nowiki>: « Texte cité »
<blockquote>Texte en bloc de citation</blockquote></nowiki></pre>


= Code inline et texte non interprété =
* <code>&lt;nowiki&gt;</code> : courts extraits
Pour afficher du code ou empêcher l’interprétation de la syntaxe wiki :
* <code>&lt;pre&gt;</code> : blocs complets
* utiliser <code>&lt;nowiki&gt;</code> pour de courts extraits,
* combinaison possible
* utiliser <code>&lt;pre&gt;</code> pour des blocs complets,
* combiner les deux pour plus de sécurité.


Cette méthode est utilisée dans toutes les pages d’aide pour afficher les exemples.
Exemple :
<pre><nowiki><nowiki>[[Texte affiché tel quel]]</nowiki></nowiki></pre>


[[Catégorie:Aide]]
[[Catégorie:Aide à la rédaction]]

Dernière version du 5 février 2026 à 18:33


Syntaxe MediaWiki – bases

Cette page présente les éléments essentiels de la syntaxe MediaWiki utilisés sur le wiki de Nefald.

Elle couvre la mise en forme simple. Pour des cas plus complexes, voir → Aide:Syntaxe avancée.

---

Paragraphes et sauts de ligne

Un simple retour à la ligne ne crée pas de nouveau paragraphe.

Règles :

  • laisser une ligne vide pour séparer deux paragraphes
  • utiliser <br> uniquement pour un saut de ligne interne

Exemple :

Ligne 1 sans saut
Ligne 2 (même paragraphe)


Nouveau paragraphe
Ligne 1<br>Ligne 2 après saut manuel

---

Titres

Les titres structurent la page et génèrent la table des matières.

Syntaxe :

= Niveau 1 =
== Niveau 2 ==
=== Niveau 3 ===
==== Niveau 4 ====

Règles :

  • un seul niveau 1 par page
  • hiérarchie logique
  • ne pas sauter de niveau

---

Gras et italique

Utiliser la syntaxe wiki plutôt que le HTML.

Syntaxe :

''italique''
'''gras'''
'''''gras et italique'''''

Éviter :

<b>gras</b> <i>italique</i>

---

Listes

Les listes améliorent la lisibilité.

Syntaxe :

* Élément
* Élément
** Sous-élément
# Élément 1
# Élément 2
## Sous-élément 2.1

Règles :

  • utiliser des listes pour les énumérations
  • conserver une structure cohérente

---

Liens

Les liens internes facilitent la navigation.

Syntaxe :

[[Page]]
[[Page|Texte affiché]]
[https://exemple.tld Texte affiché]

Bonnes pratiques :

  • lier le premier terme important
  • éviter les liens répétés
  • privilégier les liens internes

---

Commentaires (invisibles)

Permettent d’ajouter des notes internes non affichées.

Syntaxe :

Texte visible <!-- Commentaire invisible -->

---

Ligne horizontale

Séparation visuelle simple.

Syntaxe :

----

À utiliser avec parcimonie.

---

Citations

Deux méthodes courantes :

Syntaxe :

: Texte cité
<blockquote>Bloc de citation</blockquote>

---

Code et texte non interprété

Pour afficher du code ou empêcher l’interprétation wiki :

  • <nowiki> : courts extraits
  • <pre> : blocs complets
  • combinaison possible

Exemple :

<nowiki>[[Texte affiché tel quel]]</nowiki>
Les témoins (''cookies'') nous aident à fournir nos services. En utilisant nos services, vous acceptez notre utilisation de témoins.