Aide : Syntaxe de base

Objectif

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é.

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.

Sauts de ligne et paragraphes

Dans MediaWiki, un simple retour à la ligne ne crée pas un nouveau paragraphe.

Règles à retenir :

laisser une ligne vide pour créer un nouveau paragraphe,
utiliser la balise <br> uniquement pour forcer un saut de ligne à l’intérieur d’un paragraphe.

À écrire :

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


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

Titres

Les titres permettent de structurer une page et de générer automatiquement la table des matières.

Ils existent sur plusieurs niveaux, de 1 à 6, et utilisent le caractère =.

À écrire :

= Titre de niveau 1 =
== Titre de niveau 2 ==
=== Titre de niveau 3 ===
==== Titre de niveau 4 ====

Bonnes pratiques :

un seul titre de niveau 1 par page,
ne pas sauter de niveau (éviter de passer de 2 à 4).

Gras et italique

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 :

''italique''
'''gras'''
'''''gras et italique'''''
<b>gras (HTML)</b> et <i>italique (HTML)</i>

Listes

Les listes permettent d’organiser des informations de manière claire.

Types de listes :

listes à puces avec *,
listes numérotées avec #.

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

À écrire :

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

Liens

Les liens permettent de relier les pages entre elles ou vers des ressources externes.

Types de liens :

liens internes : Page ou Texte affiché,
liens externes : Texte affiché.

À écrire :

[[Alderheim]]
[[Alderheim|capitale]]
[https://wiki.nefald.fr Page d’accueil du wiki]
[[Alderheim#Histoire|Section Histoire]]

Commentaires (non affichés)

Il est possible d’ajouter des commentaires invisibles pour le lecteur. Ils sont utiles pour laisser des notes internes.

À écrire :

Texte visible <!-- Ceci ne s’affiche pas -->

Lignes horizontales

Une ligne horizontale permet de marquer une séparation visuelle dans une page.

Elle s’obtient avec quatre tirets seuls sur une ligne.

À écrire :

Texte avant
----
Texte après

Citations

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

l’indentation avec :,
la balise <blockquote> pour un bloc de citation.

À écrire :

: « Texte cité »
<blockquote>Texte en bloc de citation</blockquote>

Code inline et texte non interprété

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

utiliser <nowiki> pour de courts extraits,
utiliser <pre> 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.