Mise en forme

From mediawiki.org
This page is a translated version of the page Help:Formatting and the translation is 95% complete.
Outdated translations are marked like this.
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public. PD
Voir aussi : Help:Advanced editing

Vous pouvez formater votre texte en utilisant des balises wiki. Ces dernières sont constituées de caractères normaux comme les astérisques, les apostrophes, ou le signe égal dont la signification change au sein du wiki en fonction de leur position. Par exemple, pour mettre un texte en italique, il suffit de l'inclure entre deux paires d'apostrophes comme ceci ''ceci''.

Balises de formatage de texte

Description Saisie Résultat
Formatage des caractères (en ligne) – s'applique n'importe où dans le texte
Texte en italique
''italique''

italique

Texte en gras
'''gras'''

gras

Gras et italique
'''''gras & italique'''''

gras & italique

Balise d'échappement d'interprétation
<nowiki>pas de ''balise'' [[wiki]]</nowiki>

pas de ''balise'' [[wiki]]

Formatage de section – seulement en début de ligne
Titres de section de différents niveaux
== Niveau 2 ==

=== Niveau 3 ===

==== Niveau 4 ====

===== Niveau 5 =====

====== Niveau 6 ======

  • N’utilisez pas le niveau 1, c’est le niveau du titre de la page.
  • N’insérez aucun texte sur la même ligne après les signes égal de fermeture.
  • Un article avec 4 titres de section ou plus crée automatiquement une table des matières (Toc) à moins d’inclure le mot magique __NOTOC__.

Niveau 2

Niveau 3

Niveau 4

Niveau 5
Niveau 6
Trait horizontal
Texte avant le trait
----
Texte après le trait

Texte avant le trait


Texte après le trait

Liste à puces
* Commencer chaque ligne
* avec un [[Wikipedia:asterisk|astérisque]] (*).
** Plus d’astérisques donnent des niveaux plus imbriqués
*** et encore plus d'astérisques, plus d'imbrications ...
* Le saut de ligne <br />ne change pas le niveau.
*** Mais le saut d'un niveau crée un espace vide.
Tout autre début de ligne met fin à la liste.

* Combiner une liste à puces
** avec une définition
::- définition
** crée un espace vide.

* Combiner une liste à puces
** avec une définition
*:- définition
** sans espace vide.

*liste à puces
:- définition
:* sous-liste qui ne crée pas
:* d’espaces vides après la définition
  • Commencer chaque ligne
  • avec un astérisque (*).
    • Plus d’astérisques donnent des niveaux en plus
      • et encore plus d'astérisques, plus de niveaux ...
  • Le saut de ligne
    ne change pas le niveau.
      • Mais le saut de niveaux crée un espace vide.

Tout autre début de ligne met fin à la liste.

  • Combiner une liste à puces
    • avec une définition
- définition
    • crée un espace vide.
  • Combiner une liste à puces
    • avec une définition
    - définition
    • sans espace vide.
  • liste à puces
- définition
  • sous-liste qui ne crée pas
  • d’espaces vides après la définition
Liste numérotée
# Commencer chaque ligne
# avec un [[Wikipedia:Number_sign|dièse]] (#).
## Plus de dièses donnent des niveaux en plus
### et encore plus, plus de niveaux ...
# Le saut de ligne <br />ne change pas le niveau.
### Mais le saut de niveaux crée un espace vide.
# Une ligne vide

# met fin à la liste en cours et en débute une nouvelle.
Tout autre début de ligne met fin à la liste.

<nowiki>#</nowiki> utilise les balises <code>nowiki</code> pour afficher un littéral (#) au début d'une ligne sans l'interpréter comme une liste numérotée.
  1. Commencer chaque ligne
  2. avec un dièse (#).
    1. Plus de dièses donnent des niveaux en plus
      1. et encore plus, plus de niveaux ...
  3. Le saut de ligne
    ne change pas le niveau.
      1. Mais le saut d'un niveau créé un espace vide.
  4. Une ligne vide
  1. met fin à la liste en cours et en débute une nouvelle.

Tout autre début de ligne met fin à la liste.

# utilise les balises nowiki pour afficher un littéral (#) au début d'une ligne sans l'interpréter comme une liste numérotée.

Liste de définitions
;item 1
: définition 1
;item 2
: définition 2-1
: définition 2-2
Si la ligne commence par un point-virgule (;), tout caractère deux points (:) se trouvant à la fin, ne sera pas affiché. Si vous voulez voir les deux points, le caractère doit être échappé ainsi &#58;.
item 1
définition 1
item 2
définition 2-1
définition 2-2
Indentation de texte
: Indentation simple
:: Double indentation
::::: Indentation multiple

Cette façon de procéder peut nuire à la lisibilité.
Indentation simple
Double indentation
Indentation multiple
Mélange de différents types de liste
# un
# deux
#* deux point un
#* deux point deux
# trois 
#; trois, item un
#: trois, définition une
# quatre
#: quatre, définition une 
#: cette façon de faire ressemble à une suite
#: et est d'ailleurs souvent utilisé
#: plutôt <br> que <nowiki><br></nowiki>
# cinq
## cinq, sous-niveau 1
### cinq, sous-niveau 1, sous-niveau 1
## cinq, sous-niveau 2

L'utilisation de #: et de *: pour sauter une ligne dans un niveau peut nuire à la lisibilité.
  1. un
  2. deux
    • deux point un
    • deux point deux
  3. trois
    trois, item un
    trois, définition une
  4. quatre
    quatre, définition une
    cette façon de faire ressemble à une suite
    et est d'ailleurs souvent utilisé
    plutôt
    que <br>
  5. cinq
    1. cinq, sous-niveau 1
      1. cinq, sous-niveau 1, sous-niveau 1
    2. cinq, sous-niveau 2
Texte préformaté
 Commencer chaque ligne par une espace.
 Le texte est '''préformaté''' et
 le ''marquage'' '''''est''''' alors possible.

Cette façon de déclarer un texte comme étant préformaté s'applique à la section. Les balises de formatage au niveau des caractères sont toujours interprétées.
Commencer chaque ligne par une espace.
Le texte est préformaté et
le marquage est alors possible.
Bloc de texte préformaté
 <nowiki>Débuter avec un espace en début
de ligne, (avant la balise <nowiki>).

Le formatage de votre bloc est alors
      maintenu.

Cette façon de procéder est pratique
pour coller des blocs de code :

def function():
    """Chaîne de texte de documentation"""

    if True:
        print True
    else:
        print False</nowiki>
Débuter avec un espace en début
de ligne, (avant la balise <nowiki>).

Le formatage de votre bloc est alors
      maintenu.

Cette façon de procéder est pratique
pour coller des blocs de code :

def function():
    """Chaîne de texte de documentation"""

    if True:
        print True
    else:
        print False

Les paragraphes

MédiaWiki ignore les sauts de ligne simples. Pour démarrer un nouveau paragraphe, il faut laisser une ligne vierge. Il est possible de forcer un saut de ligne au sein d'un paragraphe avec la balise HTML ‎<br />.

Les balises HTML

Certaines balises HTML sont autorisées dans MediaWiki, par exemple ‎<code>, ‎<div> et ‎<span>. Ces dernières s'appliquent n'importe où, à l'endroit où elles sont placées.

Description

Saisie

Résultat
Inserted (Inséré)
(s'affiche comme souligné dans la plupart des navigateurs)
<ins>Inséré</ins>

ou

<u>Souligné</u>

Inséré

ou

Souligné

Deleted (Supprimé)
(s'affiche comme barré dans la plupart des navigateurs)
<s>Barré</s>

ou

<del>Supprimé</del>

Barré

ou

Supprimé

Texte à largeur fixe
<code>Code source</code>
Code source
Blockquotes (Blocs de citation)
Texte avant
<blockquote>Citation longue</blockquote>
Texte après
Si la citation contient plusieurs paragraphes, les balises doivent être sur des lignes séparées pour s'afficher correctement, par exemple :
<blockquote>
Premier paragraphe

Second paragraphe
</blockquote>

Texte avant

Citation longue

Texte après

Citations
<q>Ceci est une citation.</q>
L'élément « q » ne doit pas être utilisé à la place des guillemets qui ne représentent pas des éléments de citation; par exemple, il ne convient pas d'utiliser l'élément q pour marquer des passages sarcastiques.[1]
Ceci est une citation.
Comment (Commentaire)
<!-- Ceci est un commentaire -->
Les commentaires ne sont visibles
qu'en zone d'édition.

Les commentaires ne sont visibles qu'en zone d'édition.

Texte complètement formaté
<pre>
Ce texte est '''préformaté''' et
les ''balises'' '''''ne peuvent pas être'''''
interprétées
</pre>

Pour utiliser des balises dans du texte préformaté, voir « Texte préformaté » dans le tableau précédent.
Ce texte est '''préformaté''' et
les ''balises'' '''''ne sont pas'''''
interprétées
Texte préformaté Personnalisé
<pre style="color: red">
Ce texte est '''préformaté''' avec
un style et les ''balises'' 
'''''ne sont pas''''' interprétées
</pre>

Un style CSS peut être nommé dans l'attribut style.
Ce texte est '''préformaté''' avec
un style et les ''balises'' 
'''''ne sont pas''''' interprétées

Suite:

Description Saisie Résultat
Le texte préformaté par défaut a un attribut CSS (white-space: pre-wrap;) pour envelopper le texte selon la largeur disponible.
<pre>
Cette longue phrase est utilisée pour montrer les retours à la ligne. Cette phrase en plus rajoute un peu de longueur. Cette phrase en plus rajoute un peu de longueur.
</pre>
Cette longue phrase est utilisée pour montrer les retours à la ligne. Cette phrase en plus, rajoute un peu de longueur. Cette phrase en plus, rajoute un peu de longueur.
Préformatage de texte personnalisé

avec le retour à la ligne automatique désactivé

<pre style="white-space: pre;">
Cette longue phrase est utilisée pour montrer le retour à la ligne. Cette phrase en plus, rajoute un peu de longueur. Cette phrase en plus, rajoute un peu de longueur.
</pre>
Cette longue phrase est utilisée pour montrer les retours à la ligne. Cette phrase supplémentaire, rajoute un peu de longueur. Cette phrase rajoute encore un peu de longueur.


Insertion de symboles

Les symboles et autres caractères spéciaux, non disponibles au clavier, peuvent être insérés de plusieurs façons. Beaucoup de systèmes d'exploitation et de navigateurs permettent de les insérer par l'option d'un menu ou par un panneau du système. En plus, vous pouvez utiliser le WikiEditor ou le VisualEditor pour les insérer par la fenêtre d'édition.

En dernier recours, vous pouvez utiliser une séquence spéciale de caractères. Ces séquences sont appelées entités HTML. Par exemple, la séquence suivante (entité) &rarr; quand elle sera insérée apparaîtra comme le symbole HTML d'une flèche vers la droite → et &mdash; sera affiché comme un tiret médian —.


Survoler les caractères du tableau ci-dessous pour connaître les séquences correspondantes. Certains symboles non disponibles avec la police de caractère courante apparaissent comme des cases vides.
Entités représentant les symboles HTML
Á á Â â ´ Æ æ À à Α α & Å å Ã ã Ä ä Β β ¦ Ç ç ¸ ¢
Χ χ ˆ © ¤ ° Δ δ ÷ É é Ê ê È è Ε ε Η η
Ð ð Ë ë ƒ ½ ¼ ¾ Γ γ > Í í Î î ¡ Ì ì Ι ι
¿ Ï ï Κ κ Λ λ « < ¯ µ · Μ μ  
¬ Ñ ñ Ν ν Ó ó Ô ô Œ œ Ò ò Ω ω Ο ο ª º Ø ø Õ õ Ö
ö Φ φ Π π ϖ ± £ Ψ ψ " » ® Ρ ρ
Š š § ­ Σ σ ς ¹ ² ³ ß Τ τ Θ θ ϑ Þ þ ˜
× Ú ú Û û Ù ù ¨ ϒ Υ υ Ü ü Ξ ξ Ý ý ¥ ÿ Ÿ Ζ ζ
Description Saisie Résultat
Symbole du copyright &copy;
©
Symbole de la lettre grecque delta &delta;
δ
Symbole de la monnaie Euro &euro;

Voir la liste de toutes le entitées HTML dans l'article Wikipedia List of HTML entities. De plus, MediaWiki accepte deux séquences correspondant à des entités non-standard : &רלמ; et &رلم; toutes les deux considérées comme équivalent à &rlm; qui est la balise pour l'écriture de droite à gauche (right-to-left mark). (Utilisé lorsque l'on souhaite combiner des langages écrits de droite à gauche avec d'autres écrits de gauche à droite au sein d'une même page.)

Afficher les balises et entités HTML elles mêmes (en les interprétant ou non)

&amp;euro;  → &euro;
<span style="color: red; text-decoration: line-through;">Texte à corriger</span>  → Texte à corriger
&lt;span style="color: red; text-decoration: line-through;">Texte à corriger</span>  → <span style="color: red; text-decoration: line-through;">Texte à corriger</span>

Nowiki pour le HTML

‎<nowiki /> peut interdire les balises (HTML) :

  • <<nowiki />pre>  → <pre>

Mais pas les symboles d'échappement & :

  • &<nowiki />amp;  → &

Pour afficher le symbole d'échappement & dans un texte, il faut utiliser « &amp; » pour remplacer le caractère « & » (par exemple utiliser « &amp;nbsp; », donnera « &nbsp; »).

Autres formatages

En plus des balises de formatage de texte ci-dessus, il existe des références pour d'autres formatages :

Plus de références sur la page Aide:Sommaire .

Références