Aide:Listes

This page is a translated version of the page Help:Lists and the translation is 100% complete.
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

Cette page décrit la création de listes dans MediaWiki.

Les bases

MediaWiki permet de créer trois types de listes : les listes non ordonnées (listes à puces), les listes ordonnées et les listes de définitions.

En bref

Listes non ordonnées
Chaque élément se trouve sur une nouvelle ligne qui commence par un astérisque * par exemple * item.
Listes ordonnées
Chaque élément se trouve sur une nouvelle ligne qui commence par un croisillon (hash) # par exemple # item.
Listes de définitions
Chaque élément est composé de deux parties : un terme et une description.
Le terme se trouve sur une nouvelle ligne qui commence par un point virgule (semicolon) ; par exemple ; term.
La description suit sur la même ligne après un caractère deux-points (colon) : par exemple ; terme : description,
ou alors la description commence sur sa propre ligne en commençant par les deux points : par exemple : description (on peut associer plusieurs descriptions à un même terme, chacune d'elle doit commencer par un deux-points et sur une nouvelle ligne).

En allant un peu plus loin

Dans le tableau suivant, vous trouverez quelques exemples des deux méthodes :

Wikicode Rendu
* Les listes sont très simples à créer :
** commencer chaque ligne
* par une étoile
** plus d’étoiles entrainent
*** des niveaux d’imbrication plus profonds
  • Les listes sont très simples à créer :
    • commencer chaque ligne
  • par une étoile
    • plus d’étoiles entrainent
      • des niveaux d’imbrication plus profonds
* Une nouvelle ligne
* dans une liste
permet de clore la liste.
Bien sûr
* vous pouvez
* en commencer une autre.
  • Une nouvelle ligne
  • dans une liste

permet de clore la liste. Bien sûr

  • vous pouvez
  • en commencer une autre.
# Les listes ordonnées sont bien
## très organisées
## faciles à suivre
  1. Les listes ordonnées sont bien
    1. très organisées
    2. faciles à suivre
* Vous pouvez également
** séparer les lignes
** comme ceci
  • Vous pouvez également
    • séparer les lignes
    • comme ceci
; Listes de descriptions ou de définitions
; terme : définition
; point-virgule suivi d’un terme
: deux-points suivi d’une définition
Listes de définitions
élément
définition
point-virgule suivi d’un terme
deux-points suivi d’une définition
; Listes de définitions imbriquées
; élément 1 : définition
:; sous-élément 1 suivi d’un terme
:: deux fois deux-points suivi d’une définition
:; sous-élément 2 : deux-points suivi de la définition
; élément 2
: retour à la liste principale
Listes de définitions imbriquées
élément 1
définition
sous-élément 1 suivi d’un terme
deux fois deux-points suivi d’une définition
sous-élément 2
deux-points suivi de la définition
élément 2
retour à la liste principale
* Ou encore créer des listes mixtes
*# et imbriquer les termes
*#* comme ceci
*#*; définitions
*#*: travail :
*#*; pomme
*#*; banane
*#*: fruits
  • Ou encore créer des listes mixtes
    1. et imbriquer les termes
      • comme ceci
        définitions
        travail :
        pomme
        banane
        fruits

Listes composées de plusieurs lignes

Par souci de simplicité, les éléments d’une liste en wikicode ne peuvent constituer qu’un unique paragraphe. Une ligne vide forcera l’arrêt de la liste et remettra à zéro le compteur des listes ordonnées. Séparer les listes non ordonnées n’a en général aucun effet visible.

Il est possible de placer des paragraphes sous un même élément de liste en utilisant des balises HTML. Si vous devez écrire plus d'une ligne de texte, ajoutez deux symboles de passage à la ligne, <br /><br />, pour obtenir l'effet désiré. Si vous encadrez le texte avec ‎<p>...‎</p>, il sera mis dans un nouveau paragraphe et commencera sur une nouvelle ligne quand il sera affiché.

Continuer un élément de liste après une sous-liste

En HTML, une liste peut contenir plusieurs sous-listes, sans qu’elles se suivent nécessairement. Il est donc possible qu’une liste soit entrecoupée par d'autres sous-listes. Néanmoins, dans la syntaxe wiki, les sous-listes suivent les mêmes règles que les sections d’une page : la seule partie d’un élément de liste qui puisse être en dehors d’une sous-liste doit se trouver avant la première sous-liste.

Dans le cas d’une liste à puces de premier niveau en wikicode, cette limitation peut être contournée en décomposant la liste  en plusieurs listes; le texte indenté entre les listes partielles peut alors paraitre faire partie de l’élément précédant la sous-liste. Cependant, en fonction du style CSS, il est possible qu’une ligne vide s’affiche avant et après chaque liste, auquel cas et par souci d’uniformisation, chaque élément d’une liste de premier niveau doit constituer une liste séparée.

Les listes numérotées montrent que ce qui doit ressembler à une seule liste et qui est en réalité pour le logiciel, une suite de listes. Le rendu est similaire pour les listes à puces, à la différence que le problème de la numérotation repartant de 1 ne se pose pas.

Wikicode Rendu
<ol>
  <li>élément de liste A1
    <ol>
      <li>élément de liste B1</li>
      <li>élément de liste B2</li>
    </ol>continuation de l’élément de liste A1
  </li>
  <li>élément de liste A2</li>
</ol>
  1. élément de liste A1
    1. élément de liste B1
    2. élément de liste B2
    continuation de l’élément de liste A1
  2. élément de liste A2
vs.
#élément A1
##élément B1
##élément B2
#:suite de l’élément A1
#élément A2
  1. élément A1
    1. élément B1
    2. élément B2
    suite de l’élément A1
  2. élément A2

À un niveau d’imbrication supplémentaire, lorsqu’on reprend un élément d’une sous-liste à la suite d’une sous-sous-liste, on obtient encore plus de lignes vides ; mais la liste de premier niveau continue sans être affectée :

Wikicode Rendu
#élément A1
##élément B1
###élément C1
##:suite de l’élément B1
##élément B2
#élément A2
  1. élément A1
    1. élément B1
      1. élément C1
      continuation de l’élément B1
    2. élément B2
  2. élément A2

Voir aussi m:Template:List demo.

Il est possible d'imbriquer des listes non numérotées à l'intérieur d'éléments numérotés :

Wikicode Rendu
# list item A
#* nested bullet A1
#* nested bullet A2
# continuing list item B
#* nested bullet B1
#* nested bullet B2
  1. list item A
    • nested bullet A1
    • nested bullet A2
  2. continuing list item B
    • nested bullet B1
    • nested bullet B2

Changer le type d’une liste

Par liste

Le type de liste (marqueur apparaissant avant les éléments de la liste) peut être changé en CSS en assignant la propriété list-style-type :

Wikicode Rendu
<ol style="list-style-type:lower-roman">
  <li>À propos de l’auteur</li>
  <li>Avant-propos de la première édition</li>
  <li>Avant-propos de la seconde édition</li>
</ol>
  1. À propos de l’auteur
  2. Avant-propos de la première édition
  3. Avant-propos de la seconde édition
<ol style="list-style-type:lower-alpha">
  <li>À propos de l’auteur</li>
  <li>Avant-propos de la première édition</li>
  <li>Avant-propos de la seconde édition</li>
</ol>
  1. À propos de l’auteur
  2. Avant-propos de la première édition
  3. Avant-propos de la seconde édition

Valable sur tout le site

Le wikicode classique #, ##, ### peut être utilisé avec le CSS dans MediaWiki:Common.css pour produire le système usuel des listes numérotées (1, 2, 3; puis a, b, c; puis i, ii, iii) :

ol { 
	list-style-type: decimal; 
}
ol li > ol { 
	list-style-type: lower-alpha; 
}
ol li > ol li > ol { 
	list-style-type: lower-roman; 
}

Le premier ol ci-dessus est la valeur par défaut, donc pas nécessairement inutile sauf si un autre list-style-type est nécessaire.

Wikicode Rendu
#list item A1
##list item B1
###list item C1
###list item C2
##list item B2
#list item A2
  1. list item A1
    1. list item B1
      1. list item C1
      2. list item C2
    2. list item B2
  2. list item A2

Augmenter l’indentation d’une liste

Pour une liste numérotée avec grande taille de police, certains navigateurs ne montrent pas plus de deux chiffres, à moins d’imposer une indentation supplémentaire (dans le cas où il y a plusieurs deux-points, pour chacun d’entre eux). On peut le faire en utilisant le CSS :

ol { margin-left: 2cm}

ou d’une autre manière, comme suit :

Wikicode Rendu Commentaires
:#abc
:#def
:#ghi
 
  1. abc
  2. def
  3. ghi
Une liste d’une ou plusieurs lignes démarrant par deux-points crée une liste de définitions sans terme à définir, et dont les éléments comptent pour des descriptions de définitions, étant ainsi indentées. Cependant, si les deux-points sont suivis des signes « * » ou « # » d'une liste non-ordonnée ou ordonnée, la liste est traitée comme une description de définition, et donc la liste complète est indentée.
<ul>
  <ol>
    <li>abc</li>
    <li>def</li>
    <li>ghi</li>
  </ol>
</ul>
  1. abc
  2. def
  3. ghi
MediaWiki traduit les listes non ordonnées (ul) sans aucun élément de liste (li) par un « div » comportant une style="margin-left: 2em", ce qui cause une indentation du contenu. C’est la méthode la plus versatile, puisqu’elle permet de démarrer avec un numéro différent de 1, voir ci-dessous.
<ul>
#abc
#def
#ghi
</ul>
    1. abc
    2. def
    3. ghi
    Comme ci-dessus, mais en exprimant le contenu de la « liste non ordonnée sans aucun élément de liste » avec les « # » produisant une liste ordonnée. Le code HTML obtenu, et donc le rendu, reste identique. C’est la méthode recommandée lorsque la liste commence à 1.

    Pour montrer que les trois méthodes affichent tous les chiffres des numéros à 3 chiffres, voir Démo de liste.

    Choisir le numéro de départ d’une liste numérotée

    On peut faire démarrer une liste ordonnée avec le numéro que l'on veut en utilisant la syntaxe HTML.

    <ol start="9">
    <li>Amsterdam</li>
    <li>Rotterdam</li>
    <li>La Hague</li>
    </ol>
    
    1. Amsterdam
    2. Rotterdam
    3. La Hague

    Ou bien :

    <ol>
    <li value="9">Amsterdam</li>
    <li value="8">Rotterdam</li>
    <li value="7">La Hague</li>
    </ol>
    
    1. Amsterdam
    2. Rotterdam
    3. La Hague

    Comparaison avec un tableau

    Outre la numérotation automatique, la liste ordonnée aligne également le contenu de ses éléments, de manière comparable à la syntaxe des tableaux :

    {|
    |-
    | align=right |  9.|| Amsterdam
    |-
    | align=right | 10.|| Rotterdam
    |-
    | align=right | 11.|| La Hague
    |}
    

    donne :

    9. Amsterdam
    10. Rotterdam
    11. La Hague

    Cette numérotation manuelle a l’avantage de ne pas fausser les numéros correspondants aux références textuelles lorsque l'on ajoute ou que l'on supprime un élément de la liste.

    Liste sur plusieurs colonnes

    Voir aussi Template:Col-begin, Template:Col-break, Template:Col-end.

    Liste à puces sur plusieurs colonnes

    <div style="column-count:2">
    * pomme
    * tapis
    * géographie
    * montagne
    * nulle part
    * courrier
    * en lambeaux
    * tartine
    </div>
    

    donne :

    • pomme
    • tapis
    • géographie
    • montagne
    • nulle part
    • courrier
    • en lambeaux
    • tartine
    <div style="column-count:3">
    * pomme
    * tapis
    * géographie
    * montagne
    * nulle part
    * courrier
    * en lambeaux
    * tartine
    </div>
    

    donne :

    • pomme
    • tapis
    • géographie
    • montagne
    • nulle part
    • courrier
    • en lambeaux
    • tartine

    Liste numérotée sur plusieurs colonnes

    <div style="column-count:3">
    #pomme
    #tapis
    #géographie
    #montagne
    #nulle part
    #courrier
    #en lambeaux
    #tartine
    </div>
    

    donne :

    1. pomme
    2. tapis
    3. géographie
    4. montagne
    5. nulle part
    6. courrier
    7. en lambeaux
    8. tartine

    Ci-dessous, un numéro de départ est défini en utilisant la syntaxe HTML (pour la première colonne, la syntaxe wiki ou HTML peuvent être utilisées).

    En combinaison avec l’indentation supplémentaire mentionnée dans la section précédente :

    {| valign="top"
    |-
    |<ul><ol start="125"><li>a</li><li>bb</li><li>ccc</li></ol></ul>
    |<ul><ol start="128"><li>ddd</li><li>ee</li><li>f</li></ol></ul>
    |}
    

    donne :

      1. a
      2. bb
      3. ccc
        1. ddd
        2. ee
        3. f

        L’utilisation de m:Template:multi-column numbered list permet le calcul automatique des numéros de départ. Seul le premier numéro ainsi que le nombre d’éléments dans chaque colonne doivent être spécifiés (sauf pour la dernière). Ajouter ou supprimer un élément d’une colonne nécessite de réajuster seulement le nombre d’éléments de cette colonne, plutôt que de modifier les numéros de départ de chacune des colonnes suivantes.

        {{Multi-column numbered list|125|a<li>bb<li>ccc|3|<li>ddd<li>ee<li>f}}
        

        donne :

          1. a
          2. bb
          3. ccc
            1. ddd
            2. ee
            3. f
            {{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
            

            donne :

              1. a
              2. bb
              3. ccc
                1. ddd
                2. ee
                  1. f
                  {{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
                  

                  donne :

                    1. a
                    2. bb
                    3. ccc
                      1. ddd
                      2. ee
                        1. f
                        {{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}
                        

                        donne :

                          1. a
                          2. bb
                          3. ccc
                            1. ddd
                            2. ee
                              1. f

                              Liste simplifiée ou style horizontal

                              Il est également possible de présenter des listes courtes avec une mise en forme très simple telle que :

                              ''Titre de liste :'' exemple 1, exemple 2, exemple 3

                              Titre de liste : exemple 1, exemple 2, exemple 3

                              Ce style occupe moins de place sur la page et il est préférable si la liste ne comporte que quelques éléments, il est facilement lisible et modifiable. Les éléments de la liste doivent commencer par une minuscule (sauf si ce sont des noms propres).

                              Tableau

                              Un tableau avec une seule colonne ressemble beaucoup à une liste, mais il offre la possibilité d'être trié. Si le wikicode lui-même est déjà trié avec la même clé de tri, il n'y a aucun avantage. Un tableau avec plusieurs colonnes vous permet de trier sur n'importe quelle d'entre-elles.

                              Voir également Quand utiliser les tableaux .

                              Changer les listes non ordonnées en listes numérotées

                              Avec le CSS :

                              ul { list-style: decimal }
                              

                              les listes non ordonnées sont transformées en listes numérotées. Cela s’applique à toutes les listes ul du code source HTML (pour autant qu’un sélecteur CSS ne l'empêche pas) :

                              • celles produites avec *
                              • celles produites par ‎<ul> dans le wikicode
                              • celles produites par le système

                              Chaque page spéciale, tout comme les autres pages, possède une classe dont l’intitulé dépend du nom de la page, il est donc possible de spécifier pour chaque type si la liste doit être ordonnée. Voir aussi Contributions de l’utilisateur et Pages liées.

                              Il ne semble cependant pas possible de numéroter les listes de tout l’historique de la page (à moins de numéroter toutes les listes), car le nom de classe dépend du nom de la page dont c’est l’historique.

                              Voir aussi