Voir la source de Scratch Wiki en français:Formater le texte

{{Titre|Formater le texte}}

La '''mise en forme du texte d'une page''' est essentielle car elle permet de mettre en valeur les éléments importants.

== Titres ==

=== Titre principal ===

Un '''titre''' permet d'indiquer clairement au lecteur de quoi traite la page.

S'il existe différents niveaux de [[#Titres de sections|titres de sections]], chaque page possède un seul et unique [[Modèle:Titre|titre]] principal. 

{| class="wikitable"
|+ [[Modèle:Titre|Titre]]
|-
!Ce que vous tapez : !! Ce que vous obtenez :
|-
| <code><nowiki>{{Titre|Titre principal}}</nowiki></code> || {{Titre|Titre principal}}
|}

=== Titres de sections ===

Une page doit être organisée pour être simple à lire et compréhensible.
Les '''titres de sections''' sont le meilleur moyen d'organiser une page.

Tout est repris dans le tableau suivant : {{FloatClear}}

Le titre de niveau 1 s'obtient avec <pre>=texte=</pre>, le titre de niveau 2 avec <pre>==texte==</pre> et ainsi de suite (5 niveaux supportés).
<!-- pas affichés pour des raisons d'organisation et de sommaire -->

{{Info|Un article avec plus de 4 sections titrées crée automatiquement un sommaire.}}

{{Attention|Le '''niveau 1''' ne doit pas être utilisé, en effet, c'est le niveau utilisé par le [[#Titre|titre]] principal d'une page.}}

== Mise en forme du texte ==

=== Effets de texte ===

{| class="wikitable"
! Description :
! Ce que vous tapez :
! Ce que vous obtenez :
|-
|Texte en gras
|<code><nowiki>'''Texte en gras'''</nowiki></code>
|'''Texte en gras'''
|-
|Texte en italique
|<code><nowiki>''Texte en italique''</nowiki></code>
|''Texte en italique''
|-
|Texte en italique et en gras
|<code><nowiki>'''''Texte en italique'''''</nowiki></code>
|'''''Texte en italique'''''
|}

=== Taille du texte ===

{| class="wikitable"
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Grand texte
|<code><nowiki><big>Grand texte</big></nowiki></code>
|<big>Grand texte</big>
|-
|Petit texte
|<code><nowiki><small>Petit texte</small></nowiki></code>
|<small>Petit texte</small>
|}

{{Info|Les différentes tailles de texte ne sont pas utilisées sur les pages wiki.}}

=== Lignes de base ===

{| class="wikitable"
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Texte en exposant
|<code><nowiki><sup>Texte en exposant</sup></nowiki></code>
|<sup>Texte en exposant</sup>
|-
|Texte en indice
|<code><nowiki><sub>Texte en indice</sub></nowiki></code>
|<sub>Texte en indice</sub>
|}

=== Texte brut ===

Le '''texte brut''' est un texte où aucune balise ou option ne sera active.

{| class="wikitable"
|+ [[Modèle:Titre|Titre]]
|-
!Ce que vous tapez : !! Ce que vous obtenez :
|-
| <code>&lt;nowiki&gt;<nowiki>texte '''non''' formaté</nowiki>&lt;/nowiki&gt;</code> 
| <nowiki>texte '''non''' formaté</nowiki>
|-
| <code><nowiki><pre>texte '''non''' formaté</pre></nowiki></code> 
| <pre>texte '''non''' formaté</pre>
|}

<!-- utilisation du texte par html pour afficher le nowiki, pas d'autre méthode -->

== Mise en page ==

=== Paragraphes ===

Pour commencer un nouveau '''paragraphe''', laissez deux lignes vides. Ainsi : 

{| class="wikitable"
|+ Paragraphes
|-
!Ce que vous tapez : !! Ce que vous obtenez :
|-
| <code>Premier paragraphe <br> <br>Second paragraphe </code> 
|Premier paragraphe <br> <br> Second paragraphe
|}

{{Info|L'utilisation de la balise <pre><br></pre> pour sauter une ligne est à éviter car source de confusion.}}
{{Info|Si le double retour à la ligne ne fonctionne pas (comme après utilisation de balise <pre><code></code></pre>), utilisez le modèle <pre>{{FloatClear}}</pre> pour supprimer l'effet indésirable.}}

=== Structures complexes ===

==== Listes ====

Les '''listes''' ou listes à puces équivalent à un tableau à un colonne mais avec profondeur. C'est un bon moyen de lister des exemples et une syntaxe à savoir utiliser sur le wiki.

{| class="wikitable"
! Description :
! Ce que vous tapez :
! Ce que vous obtenez :
|-
|Liste à puces
|<code><nowiki>* un
** un point un
** un point deux
* deux
</nowiki></code>
|
* un
** un point un
** un point deux
* deux
|-
|Liste à numéros
|
<code><nowiki># un
## un point un
## un point deux
# deux
</nowiki></code>
|
# un
## un point un
## un point deux
# deux
|-
|Liste de définitions
|<code><nowiki>
;chose 1
: définition 1
;chose 2
: définition 2-1
: définition 2-2
</nowiki></code>
|
;chose 1
: définition 1
;chose 2
: définition 2-1
: définition 2-2
|-
| Faire un retrait au texte
|
<code><nowiki>
: Retrait simple
:: Double retrait
::::: Retrait multiple
</nowiki></code>
{{Info|Ce type de liste ne doit être utilisé que dans les pages de discussion.}}
|
: Retrait simple
:: Double retrait
::::: Retrait multiple
|}

{{FloatClear}}
Les combinaisons sont bien sûr possibles.

==== Tableaux ====

Les '''tableaux''' permettent d'ordonner de manière efficace des données.

{{Idée|Un tableau est difficile à construire à la main. Utilisez l'option « tableau » dans la barre d'outils MediaWiki pour vous simplifier l'écriture.}}


===== Tableau simple (3x2 + en-tête + titre) =====
<code><nowiki>{| class="wikitable" border="1"
|+ titre
|-
! en-tête 1
! en-tête 2
! en-tête 3
|-
| ligne 1, case 1
| ligne 1, case 2
| ligne 1, case 3
|-
| ligne 2, case 1
| ligne 2, case 2
| ligne 2, case 3
|}</nowiki></code>
{|class="wikitable" border="1"
|+ titre
|-
! en-tête 1
! en-tête 2
! en-tête 3
|-
| ligne 1, case 1
| ligne 1, case 2
| ligne 1, case 3
|-
| ligne 2, case 1
| ligne 2, case 2
| ligne 2, case 3
|}
{{FloatClear}}

Les tableaux ne peuvent pas être placés dans un autre tableau.

===== Construction d'un tableau =====
* les balises <pre>{| … |}</pre> indiquent le début et la fin d'un tableau ;
* une liste d'attributs facultatifs :
** l'attribut <pre>class=""</pre> défini une classe de tableau, avec pour seule valeur possible <pre>wikitable</pre> ;
** l'attribut <pre>border=""</pre> défini la largeur des bordures du tableau, avec comme valeur par défaut <pre>1</pre> ;
** l'attribut <pre>style=""</pre> défini un style CSS, avec comme principale valeur <pre>style="caption-side:bottom;"|sous titre du tableau</pre>
* la balise <pre>|+</pre> indique un titre si placée en première ligne ;
* les balises <pre>|</pre> et <pre>!</pre> indiquent une nouvelle case, notez que ces dernières seront des cases d'en-tête ;
* les balises <pre>|-</pre> indiquent une nouvelle ligne.

=== HTML ===
Certaines balises '''[[wikipedia:HTML|HTML]]''' sont fonctionnelles.
Elles sont appliquées partout où vous les mettez et elles peuvent se cumuler.

Notez qu'elles ont parfois des '''alternatives''' qui sont à '''privilégier'''.

{|class="wikitable"
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Souligné
|<code><nowiki><u>souligné</u></nowiki></code>
|<u>souligné</u>
|-
|Barré
|<code><nowiki><del>Barré</del></nowiki></code> <br> <code><nowiki><s>Barré</s></nowiki></code>
|<del>Barré</del>
|-
|Texte de largeur fixe
|<code><nowiki><tt>Texte de largeur fixe</tt></nowiki></code> <br> <code> Texte de largeur fixe</code>
|<tt>Texte de largeur fixe</tt> {{Info|Second cas : espace en début de ligne.}}
|-
|Code source
|<code><nowiki><code>code source</code></nowiki></code>
|<code>code source</code>
|-
|Commentaire
|<code><nowiki><!-- Ceci est un commentaire --></nowiki></code>
|<!-- Ceci est un commentaire --> {{Info|Visible uniquement dans la fenêtre d'édition.}}
|-
|Texte complètement préformaté
|<code><nowiki><pre>texte largeur fixe sans formatage</pre></nowiki></code>
|<pre>texte largeur fixe sans formatage</pre>
|-
|Barre horizontale
|<code><nowiki><hr></nowiki></code><br><code><nowiki>----</nowiki></code>
|<hr>
|}

=== Structures internes ===

==== Liens ====

Vous pouvez insérer différents types de '''liens''' dans votre texte. Il y en a deux : les internes et les externes.
On utilise les internes pour les liens internes au Wiki et les externes pour les lien externes au Wiki. C'est aussi simple que cela.


{| class="wikitable"
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|'''Lien interne''' non existant
|<code><nowiki>[[Nom de page]]</nowiki></code> {{FloatClear}}
|[[Nom de page]]
|-
|Lien interne non formaté
|<code><nowiki>[[Scratch Wiki Accueil]]</nowiki></code>
|[[Scratch Wiki Accueil]] 
|-
|Lien interne formaté
|<code><nowiki>[[Scratch Wiki Accueil|Accueil du Wiki Francophone]]</nowiki></code>
|[[Scratch Wiki Accueil|Accueil du Wiki Francophone]]
|-
|Lien interne au pluriel
|<code><nowiki>[[Scratcheur]]s</nowiki></code>
|[[Scratcheur]]s
|-
|'''Lien vers catégorie''' non formaté
|<code><nowiki>[[:Catégorie:Blocs]]</nowiki></code>
{{Info|Le symbole <pre>:</pre> indique un lien vers une catégorie.

'''Omettre ce symbole catégorise la page''' (et cache le lien).
}}
|[[:Catégorie:Blocs]]
|-
|Lien vers catégorie formaté
|<code><nowiki>[[:Catégorie:Blocs|Catégorie des blocs]]</nowiki></code>
|[[:Catégorie:Blocs|Catégorie des blocs]]
|-
|'''Lien externe'''
|<code><nowiki>http://www.example.org</nowiki><br><nowiki>[http://www.example.org]</nowiki><br><nowiki>[http://www.example.org Titre du lien]</nowiki></code>
|http://www.example.org<br>[http://www.example.org]<br>[http://www.example.com Titre du lien]
|-
|'''Lien interwiki'''
|<code><nowiki>[[:en:Scratch_Wiki_Home]]</nowiki><br><nowiki>[[:en:Scratch_Wiki_Home|Accueil Wiki anglophone]]</nowiki></code> 
{{Info|Le symbole <pre>:</pre> indique un lien vers une page interwiki.

'''Omettre ce symbole lie la page''' (et cache le lien).
}}
|[[:en:Scratch_Wiki_Home]]<br>[[:en:Scratch_Wiki_Home|Accueil Wiki anglophone]]
|}

{{FloatClear}}
==== Images ====

Les '''images''' restent le meilleur moyen d'illustrer une page.
<br><br>
''À venir, consultez la page [https://mediawiki.org/wiki/Help:Images/fr MediaWiki] dédiée pour en savoir plus.''

== Références ==

Les '''références''' permettent indiquer les sources d'un article. Elle sont très importantes sur un wiki de qualité mais doivent être sûres.

===Ajouter une référence===

{| class="wikitable" border="1"
|-
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Ajouter référence
|<code><nowiki>Texte avec une référence<ref name="test">[http://www.example.org texte pour référence], texte additionnel.</ref></nowiki></code>
|Texte avec une référence<ref name="test">[http://www.example.org texte pour référence], texte additionnel.</ref>
|-
|Ajouter une référence
|<code><nowiki><ref>[http://www.example.org lien], texte additionnel.</ref></nowiki></code>
|<ref>[http://www.example.org lien], texte additionnel.</ref>
|-
|Ajouter une référence
|<code><nowiki><ref name="test2">texte</ref></nowiki></code>
|<ref name="test2">texte</ref>
|-
|Ajouter une référence
|<code><nowiki><ref>texte</ref></nowiki></code>
|<ref>texte</ref>
|-
|Ajouter une référence '''déjà utilisée'''
|<code><nowiki><ref name="test2" /></nowiki></code>
|<ref name="test2" />
|}

{{LeSaviezVous|Les références ont un nom (<pre>name="…"</pre>) permettant de les réutiliser.
Utiliser le même nom avec deux références différentes ne fonctionnera donc pas.}}

===Afficher une référence===

{| class="wikitable" border="1"
|-
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Référence en fin de page
|<code><nowiki><references /></nowiki></code>
|<references />
|}

== Signatures (discussion) ==

Une signature permet de savoir qui a laissé quel message sur les pages de discussion.
Par défaut, vous pouvez utiliser une signature courte et une avec horodatage.

{| class="wikitable"
!Description :
!Ce que vous tapez :
!Ce que vous obtenez :
|-
|Signature courte
|<code><nowiki>~~~</nowiki></code>
|{{Utilisateur:Smrman/signature}}
<br>
|-
|Signature complète
|<code><nowiki>~~~~</nowiki></code>
|{{Utilisateur:Smrman/signature}} 16:00, 20 Juin 2016 (UTC)
<br>
|}

{{Info|Vous pouvez modifier votre signature par défaut dans les [[Spécial:Préférences|préférences]] du Wiki.}}

== Modèles principaux ==

Un '''modèle''' est un élément d'une page qui peut être répété de manière simple, en l'invoquant avec des paramètres.

=== Marques d'attention ===

{|class="wikitable" border="1" 
|-
!Modèle
!Code
!Résultat
|-
|Ajouter une information à la page.
|<code><nowiki>
{{Info
|Un détail à surement noter
}}
</nowiki></code>
|{{Info|Un détail à surement noter}}
|-
|Ajoute une suggestion d'idée pour l'utilisateur.
|<code><nowiki>
{{Idée
|En voilà une bonne idée...
}}
</nowiki></code>
|{{Idée|En voilà une bonne idée... }}
|-
|Ajoute une marque "LeSaviezVous" qui donne une info inédite à l'utilisateur.
|<code><nowiki>
{{LeSaviezVous
|Il existe un modèle pour ajouter : "le saviez vous"...
}}
</nowiki></code>
|{{LeSaviezVous|Il existe un modèle pour ajouter : "le saviez vous"...}}
|-
|Ajouter une marque d'attention à la page.
|<code><nowiki>
{{Attention
|Faites attention
}}
</nowiki></code>
|{{Attention|Faites attention}}
|-
|Ajouter une marque de danger à la page. Souvent pour indiquer une action dangereuse ou sans moyen de l'annuler.
|<code><nowiki>
{{Danger
|Ceci est extrêmement important voire dangereux
}}
</nowiki></code>
|{{Danger|Ceci est extrêmement important voire dangereux}}
|}

{{Info|Les marques d'attention se placent à la fin d'un paragraphe.}}

{{Info|Une marque d'attention peut être placée dans une marque d'attention.}}

{{Attention|Si plusieurs marques d'attention doivent être placées à la suite, veillez à les placer dans l''''ordre donné par ce tableau''' (puis dans un ordre logique).}}

=== Modèles communs ===

{| class="wikitable"
|+ 
|-
! Modèle
! Code
! Résultat
|-
| Page à finir
| <code><nowiki>{{À finir}}</nowiki></code>
| {{À finir}}
|-
| Page à supprimer
| <code><nowiki>{{À supprimer|Motif}}</nowiki></code>
| {{À supprimer|Motif}}
|-
| Page à réécrire
| <code><nowiki>{{À réécrire|motif=''exemple'', ''exemple''}}</nowiki></code>
| {{À réécrire|motif=''exemple'', ''exemple''}}
|-
| À ne pas confondre avec
| <code><nowiki>{{À ne pas confondre avec
|Chose 1
|Chose 2}}</nowiki></code> 
| {{À ne pas confondre avec
|Chose 1
|Chose 2}}
|-
| Article dédié
|<code><nowiki>{{Article principal
|lien=[[Scratch 2.0]], deuxième version majeure de Scratch}}</nowiki></code>
|  
{{Article principal
|lien=[[Scratch 2.0]], deuxième version majeure de Scratch}}
|-
| Information datée
| <code><nowiki>{{Information datée}}</nowiki></code>
| {{Information datée}}
|-
| Information à vérifier
| <code><nowiki>texte, {{À vérifier|info à vérifier}}, texte</nowiki></code>
| texte, {{À vérifier|info à vérifier}}, texte
|}

== Autres formatages ==

Consultez le guide officiel de [https://www.mediawiki.org/wiki/Project:Help/fr MediaWiki] pour découvrir tous les options de formatage.

[[Catégorie:Aide sur le wiki]]