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<br>dans les listes<br>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
MediaWiki does not support continuing a list item after a sub-list, unless the whole list is marked up with HTML.
Workarounds
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.
- is semantically different
- may display (depending on CSS) unwanted vertical space between each list (in which case, for uniformity, every first-level list item could be made a separate list)
- causes numbering to restart from 1 in numbered lists.
| 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.
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. |
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.