Aide:Listes
 |
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. Quelques versions anciennes de cette page ont été importées sous la licence CC BY-SA. Seules les nouvelles contributions sont dans le domaine public. |
|
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 |
|
* Une nouvelle ligne * dans une liste permet de clore la liste. Bien sûr * vous pouvez * en commencer une autre. |
permet de clore la liste. Bien sûr
|
# Les listes ordonnées sont bien ## très organisées ## faciles à suivre |
|
* 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 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 |
|
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>
|
|
| vs. | |
#élément A1 ##élément B1 ##élément B2 #:suite de l’élément A1 #é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 |
|
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 |
|
Changer le type d’une liste
Par liste
Le type de liste (marqueur apparaissant avant les éléments de la liste) peut être modifié par le 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>
|
|
<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>
|
|
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 |
|
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 |
|
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>
|
|
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>
|
|
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>
|
|
Ou bien :
<ol>
<li value="9">Amsterdam</li>
<li value="8">Rotterdam</li>
<li value="7">La Hague</li>
</ol>
|
|
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 :
- pomme
- tapis
- géographie
- montagne
- nulle part
- courrier
- en lambeaux
- 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 :
|
|
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 :
|
|
{{Multi-column numbered list|lst=lower-alpha|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
donne :
|
|
|
{{Multi-column numbered list|lst=lower-roman|125|a<li>bb<li>ccc|3|<li>ddd<li>ee|2|<li>f}}
donne :
|
|
|
{{Multi-column numbered list|lst=disc||a<li>bb<li>ccc||<li>ddd<li>ee||<li>f}}
donne :
|
|
|
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
- Aide:Liste sur Wikipédia en anglais
- Aide sur la syntaxe des listes sur Wikipédia en français
- Module:Sort definition list - module Scribunto permettant de trier les listes de définitions en fonction du terme défini, utile sur les wikis multilingues.