Aide:Listes

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Lists and the translation is 99% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎català • ‎français • ‎polski • ‎português • ‎slovenčina • ‎русский • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur les pages d’aide concernant le domaine public.
PD

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

Les bases

MediaWiki permet de créer trois types de listes : les listes ordonnées, les listes à puces, et les listes de définitions. Dans les sections suivantes, nous prenons pour exemple des listes ordonnées. On obtient des résultats similaires avec les listes à puces.

Wikitexte 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
; Liste de définitions
; élément : définition
; point-virgule suivi d’un terme
: deux-points suivi d’une définition
Liste 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

Paragraphes dans une liste

Par souci de simplicité, les éléments d’une liste en wikitexte 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 à puces n’a en général aucun effet visible.

Il est possible d’insérer plusieurs paragraphes dans un élément de liste en utilisant des balises HTML. On peut pour cela utiliser deux symboles de fin de ligne, <br /><br />, ou inclure les paragraphes suivant le premier entre <p>...</p>.

Pour une liste d’éléments contenant plusieurs paragraphes, il peut être nécessaire d’ajouter des lignes vides entre les éléments pour éviter la confusion.

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’un élément d’une liste soit entrecoupé par des sous-listes. À contrario pour les sous-listes en syntaxe wiki, les mêmes règles que les sections d’une page s’appliquent : 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, il est possible de contourner cette limitation en séparant la liste ; un texte indenté après une sous-liste 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 devrait constituer une liste séparée.

Les listes numérotées montrent que ce qui devrait ressembler à une seule liste 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.

<ol>
  <li>élément A1
    <ol>
      <li>élément B1</li>
      <li>élément B2</li>
    </ol>continuation de l’élément A1
  </li>
  <li>élément A2</li>
</ol>
  1. élément A1
    1. élément B1
    2. élément B2
    continuation de l’élément A1
  2. élément A2
vs.
#élément A1
##élément B1
##élément B2
#:continuation de l’élément A1
#élément A2
  1. élément A1
    1. élément B1
    2. élément B2
    continuation 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 :

#élément A1
##élément B1
###élément C1
##:continuation de l’élément B1
##élément B2
#élément A2

donne

  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.

Changer le type d’une liste

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

Wikitexte 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

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 colonnes, pour chacune d’entre elles). On peut le faire avec du CSS :

ol { margin-left: 2cm}

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

Wikitexte 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 définitions, étant ainsi indentée. Cependant, si les deux-points sont suivis par les signes « * » ou « # » d’un autre type de liste, la liste est traitée comme une unique définition, elle est donc entièrement 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) en « 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 section suivante.
<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 les 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 par le numéro qu’on veut avec la syntaxe HTML. (Le W3C a rendu obsolète les attributs $start et $value utilisés avant HTML 4.01 et XHTML 1.0. Mais depuis 2007, aucun navigateur populaire n’a implémenté les compteurs CSS qui sont censés les remplacer. Les projets Wikimedia utilisent XHTML Transitional qui comportent encore ces attributs.)

<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 le contenu de ses éléments, de manière comparable à cette syntaxe de tableau :

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

devient :

9. Amsterdam
10. Rotterdam
11. La Hague

Cette numérotation manuelle a l’avantage de ne pas fausser les références aux numéros de la liste lorsqu'elle est modifiée.

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;-moz-column-count:2;-webkit-column-count:2">
* pomme
* tapis
* géographie
* montagne
* nulle part
* courrier
* en lambeaux
* tartine
</div>

devient :

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

devient :

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

Liste numérotée sur plusieurs colonnes

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

devient :

  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 peut également être utilisée).

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

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

devient :

    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. 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 tous les numéros de départ de toutes les colonnes qui suivent.

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

devient :

    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}}

devient :

    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}}

devient :

    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}}

devient :

    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 de petites listes avec une mise en forme très simple, telles 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 sera préféré si la liste ne comporte qu’une poignée d’éléments, il est facilement lisible et n’utilise pas de puce. Les éléments de la liste commencent par une minuscule (sauf si ce sont des noms propres).

Tableau

Un tableau d’une colonne ressemble beaucoup à une liste, mais il offre la possibilité du tri. Si le wikitexte lui-même est déjà trié avec la même clé de tri, l’avantage disparait. Un tableau à plusieurs colonnes permet le tri à partir de n’importe quelle colonne.

Voir également Quand utiliser des tableaux ?.

Changer les listes à puces en listes numérotées

Avec le CSS :

ul { list-style: decimal }

les listes à puces sont transformées en listes numérotées. Cela s’applique à toutes les listes à puces 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 wikitexte
  • celles produites par le système

Chaque page spéciale, comme les autres, 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 numérotée, voir Contribution 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