« Aide:Syntaxe de base » : différence entre les versions

Navigation interactive dans l’historique

Modification suivante →

VisuelWikicode

@@ Ligne 1 : / Ligne 1 : @@
 = Aide : Syntaxe de base =
 __TOC__
 == Objectif ==
-Comprendre et utiliser les **balises** et la **syntaxe** essentielles de MediaWiki à l’aide d’exemples en code non interprété.
+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é.
-== Sauts de ligne & paragraphes ==
+== Sauts de ligne et paragraphes ==
-Un **retour à la ligne simple** n’insère pas de nouveau paragraphe. Laisser **une ligne vide** pour créer un nouveau paragraphe. Utiliser <br> pour forcer un saut de ligne.
+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 <code>&lt;br&gt;</code> uniquement pour forcer un saut de ligne à l’intérieur d’un paragraphe.
 À écrire :
@@ Ligne 18 : / Ligne 22 : @@
 Nouveau paragraphe
 Ligne 1<br>Ligne 2 après saut manuel</nowiki></pre>
 == Titres ==
-Niveaux de 1 à 6 avec = … =
+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 <code>=</code>.
 À écrire :
-<pre><nowiki>= Titre 1 =
+<pre><nowiki>= Titre de niveau 1 =
-== Titre 2 ==
+== Titre de niveau 2 ==
-=== Titre 3 ===
+=== Titre de niveau 3 ===
-==== Titre 4 ====</nowiki></pre>
+==== Titre de niveau 4 ====</nowiki></pre>
-== Gras / Italique ==
+Bonnes pratiques :
-Préférer l’italique/gras wiki, mais les balises HTML restent possibles.
+* 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 :
 <pre><nowiki>''italique''
 '''gras'''
-'''''gras + italique'''''
+'''''gras et italique'''''
 <b>gras (HTML)</b> et <i>italique (HTML)</i></nowiki></pre>
+== Listes ==
+Les listes permettent d’organiser des informations de manière claire.
-== Listes ==
+Types de listes :
-Listes à puces (*) et numérotées (#). Indenter avec plusieurs symboles.
+* listes à puces avec <code>*</code>,
+* listes numérotées avec <code>#</code>.
+L’indentation se fait en répétant le symbole.
 À écrire :
-<pre><nowiki>* Puce
+<pre><nowiki>* Élément
-* Puce
+* Élément
-** Sous-puce
+** Sous-élément
-# 1
+# Élément 1
-# 2
+# Élément 2
-## 2.1</nowiki></pre>
+## Sous-élément 2.1</nowiki></pre>
 == Liens ==
-**Interne** : [[Page]] ou [[Page|Libellé]] · **Externe** : [https://exemple.tld Libellé]
+Les liens permettent de relier les pages entre elles ou vers des ressources externes.
+Types de liens :
+* liens internes : <code>[[Page]]</code> ou <code>[[Page|Texte affiché]]</code>,
+* liens externes : <code>[https://exemple.tld Texte affiché]</code>.
 À écrire :
@@ Ligne 64 : / Ligne 77 : @@
 [https://wiki.nefald.fr Page d’accueil du wiki]
 [[Alderheim#Histoire|Section Histoire]]</nowiki></pre>
 == Commentaires (non affichés) ==
-Utiliser la balise HTML de commentaire.
+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 ==
-Quatre tirets seuls sur une ligne.
+Une ligne horizontale permet de marquer une séparation visuelle dans une page.
+Elle s’obtient avec quatre tirets seuls sur une ligne.
 À écrire :
@@ Ligne 82 : / Ligne 94 : @@
 ----
 Texte après</nowiki></pre>
 == Citations ==
-Deux options : l’indentation (:) ou la balise <blockquote>…</blockquote>.
+Pour citer un texte, deux méthodes simples existent :
+* l’indentation avec <code>:</code>,
+* la balise <code>&lt;blockquote&gt;</code> pour un bloc de citation.
 À écrire :
@@ Ligne 92 : / Ligne 105 : @@
 <blockquote>Texte en bloc de citation</blockquote></nowiki></pre>
+== Code inline et texte non interprété ==
+Pour afficher du code ou empêcher l’interprétation de la syntaxe wiki :
+* utiliser <code>&lt;nowiki&gt;</code> pour de courts extraits,
+* 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.
-== Code inline & texte non interprété ==
 [[Catégorie:Aide]]