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

Navigation interactive dans l’historique

← Modification précédente

VisuelWikicode

@@ Ligne 1 : / Ligne 1 : @@
+{{SHORTDESC:Bases essentielles de la syntaxe MediaWiki pour structurer et mettre en forme une page du wiki de Nefald.}}
 __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.
+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]].
-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]].
+== Paragraphes et sauts de ligne ==
-== Sauts de ligne et paragraphes ==
+Un simple retour à la ligne ne crée pas de nouveau paragraphe.
-Dans MediaWiki, un simple retour à la ligne ne crée pas un nouveau paragraphe.
-Règles à retenir :
+Règles :
-* laisser une ligne vide pour créer un nouveau paragraphe,
+* laisser une ligne vide pour séparer deux paragraphes
-* utiliser la balise <code>&lt;br&gt;</code> uniquement pour forcer un saut de ligne à l’intérieur d’un paragraphe.
+* utiliser <code>&lt;br&gt;</code> uniquement pour un saut de ligne interne
-À écrire :
+Exemple :
 <pre><nowiki>Ligne 1 sans saut
 Ligne 2 (même paragraphe)
@@ Ligne 23 : / Ligne 27 : @@
 Nouveau paragraphe
 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.
-Ils existent sur plusieurs niveaux, de 1 à 6, et utilisent le caractère <code>=</code>.
+Les titres structurent la page et génèrent la table des matières.
-À écrire :
+Syntaxe :
-<pre><nowiki>= Titre de niveau 1 =
+<pre><nowiki>= Niveau 1 =
-== Titre de niveau 2 ==
+== Niveau 2 ==
-=== Titre de niveau 3 ===
+=== Niveau 3 ===
-==== Titre de niveau 4 ====</nowiki></pre>
+==== Niveau 4 ====</nowiki></pre>
-Bonnes pratiques :
+Règles :
-* un seul titre de niveau 1 par page,
+* un seul niveau 1 par page
-* ne pas sauter de niveau (éviter de passer de 2 à 4).
+* hiérarchie logique
+* ne pas sauter de niveau
+---
 == 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 :
+Utiliser la syntaxe wiki plutôt que le HTML.
+Syntaxe :
 <pre><nowiki>''italique''
 '''gras'''
-'''''gras et italique'''''
+'''''gras et italique'''''</nowiki></pre>
-<b>gras (HTML)</b> et <i>italique (HTML)</i></nowiki></pre>
+Éviter :
+<pre><nowiki><b>gras</b> <i>italique</i></nowiki></pre>
+---
 == Listes ==
-Les listes permettent d’organiser des informations de manière claire.
-Types de listes :
+Les listes améliorent la lisibilité.
-* listes à puces avec <code>*</code>,
-* listes numérotées avec <code>#</code>.
-L’indentation se fait en répétant le symbole.
+Syntaxe :
-À écrire :
 <pre><nowiki>* Élément
 * Élément
@@ Ligne 65 : / Ligne 72 : @@
 # Élément 2
 ## Sous-élément 2.1</nowiki></pre>
+Règles :
+* utiliser des listes pour les énumérations
+* conserver une structure cohérente
+---
 == Liens ==
-Les liens permettent de relier les pages entre elles ou vers des ressources externes.
-Types de liens :
+Les liens internes facilitent la navigation.
-* liens internes : <code>[[Page]]</code> ou <code>[[Page|Texte affiché]]</code>,
-* liens externes : <code>[https://exemple.tld Texte affiché]</code>.
+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
+---
-À écrire :
+== Commentaires (invisibles) ==
-<pre><nowiki>[[Alderheim]]
-[[Alderheim|capitale]]
-[https://wiki.nefald.fr Page d’accueil du wiki]
-[[Alderheim#Histoire|Section Histoire]]</nowiki></pre>
-== Commentaires (non affichés) ==
+Permettent d’ajouter des notes internes non affichées.
-Il est possible d’ajouter des commentaires invisibles pour le lecteur.
-Ils sont utiles pour laisser des notes internes.
-À écrire :
+Syntaxe :
-<pre><nowiki>Texte visible <!-- Ceci ne s’affiche pas --></nowiki></pre>
+<pre><nowiki>Texte visible <!-- Commentaire invisible --></nowiki></pre>
-== 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.
+== Ligne horizontale ==
-À écrire :
+Séparation visuelle simple.
-<pre><nowiki>Texte avant
-----
+Syntaxe :
-Texte après</nowiki></pre>
+<pre><nowiki>----</nowiki></pre>
+À utiliser avec parcimonie.
+---
 == Citations ==
-Pour citer un texte, deux méthodes simples existent :
-* l’indentation avec <code>:</code>,
+Deux méthodes courantes :
-* la balise <code>&lt;blockquote&gt;</code> pour un bloc de citation.
+Syntaxe :
+<pre><nowiki>: Texte cité
+<blockquote>Bloc de citation</blockquote></nowiki></pre>
+---
+== Code et texte non interprété ==
-À é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]]