itemize

itemize est l'environnement d'une liste non ordonnée — une liste à puces. Vous enveloppez les entrées dans \begin{itemize} … \end{itemize} et commencez chacune par \item. Au lieu de chiffres, vous obtenez un marqueur en tête de chaque ligne, et lorsque vous imbriquez des listes, le marqueur change automatiquement avec la profondeur. Cette page couvre les marqueurs par défaut, comment les modifier pour un élément ou un niveau entier, l'imbrication et l'espacement entre les éléments.

Utilisation de base

Dans un environnement itemize, chaque entrée commence par \item. Tout, d'un \item au suivant (ou à \end{itemize}) constitue le corps de cette entrée ; vous pouvez couper les lignes et mettre en retrait librement — LaTeX aligne le marqueur et le retrait gauche pour vous. Une entrée peut s'étendre sur plus d'un paragraphe, mais vous ne pouvez pas avoir de corps de texte sans \item : chaque entrée doit commencer par un.

\begin{itemize}
  \item 牛乳
  \item 卵
  \item パン
\end{itemize}

Ceci définit trois entrées, chacune avec une puce pleine (•) en tête de ligne. itemize est un environnement LaTeX standard — aucun package requis. Lorsque vous voulez des numéros, saisissez enumerate ; pour une liste de définitions étiquetées, utilisez description.

Marqueurs et niveaux par défaut

itemize s'imbrique jusqu'à quatre niveaux de profondeur et le marqueur change automatiquement avec le niveau. Par défaut, le niveau 1 est une puce pleine •, le niveau 2 un tiret gras –, le niveau 3 un astérisque * et le niveau 4 un point centré ·. Chaque marqueur est tenu dans une commande — \labelitemi, \labelitemii, \labelitemiii et \labelitemiv respectivement (les i/ii/iii/iv sont des chiffres romains désignant le niveau).

Certaines classes de documents définissent des valeurs par défaut différentes, mais les classes standard (article et amis) utilisent les marqueurs ci-dessus. Pour modifier un marqueur lui-même, vous redéfinissez l'une de ces commandes avec \renewcommand, comme indiqué ci-dessous.

Listes d'imbrication

Mettez un autre itemize dans une entrée et vous obtenez une liste imbriquée. L'environnement interne va dans le corps de l'un des \item externes, et le marqueur change automatiquement avec la profondeur (• → – → * → ·). L'imbrication au-delà de quatre niveaux génère une erreur Too deeply nested. Les classes standard limitent également l'imbrication totale de tout environnement de type liste à six, donc mélanger itemize avec enumerate génère la même erreur au septième niveau.

\begin{itemize}
  \item 果物
  \begin{itemize}
    \item りんご
    \item みかん
  \end{itemize}
  \item 野菜
\end{itemize}

Ici, « Fruit » et « Légumes » sont définis au niveau 1 avec la puce •, tandis que « Pomme » et « Orange » en dessous d'eux sont au niveau 2 avec le tiret –. Un réglage plus précis par niveau et la modification globale des marqueurs sont abordés plus loin sur la page « Listes imbriquées ».

Changer le marqueur

Pour changer le marqueur d'une seule entrée, donnez une étiquette entre crochets juste après \item. Par exemple, \item[$\star$] fait du marqueur de cette entrée une étoile et \item[--] en fait un tiret. Par défaut, une telle étiquette entre crochets est placée en gras et alignée contre le corps. C'est pratique lorsque vous souhaitez qu'une entrée, par exemple dans une liste de contrôle, se démarque.

Pour changer le marqueur de un niveau entier, redéfinissez la commande label correspondante avec \renewcommand. Mettez-le dans le préambule, ou juste avant la portée où vous souhaitez qu'il prenne effet.

\renewcommand{\labelitemi}{$\diamond$}
\begin{itemize}
  \item この階層の記号は菱形になる
  \item 二つめの項目
\end{itemize}

Désormais, le marqueur de niveau 1 devient un diamant (⋄). Lorsque vous souhaitez un contrôle précis sur de nombreuses listes, le package enumitem est plus propre que les commandes de redéfinition manuelle. Chargez enumitem et vous pourrez définir le marqueur avec une option label= sur l'environnement lui-même.

\usepackage{enumitem}
% ...
\begin{itemize}[label=$\star$]
  \item 星印のリスト
  \item 二つめの項目
\end{itemize}

Espacement et listes compactes

L'espacement vertical d'une liste est régi par quelques longueurs. \topsep est l'espace ajouté au-dessus et au-dessous de la liste, \itemsep l'espace entre les entrées, \parsep l'espace entre les paragraphes d'une entrée et \partopsep un bit supplémentaire ajouté lorsque la liste suit un paragraphe. Par défaut, ceux-ci sont légèrement extensibles (longueur en caoutchouc) afin que la liste se fonde dans l'interligne de la page.

Lorsque vous souhaitez une liste compacte avec l'air expulsé, l'option nosep de enumitem est la solution la plus simple. nosep met à zéro \partopsep, \topsep, \itemsep et \parsep ensemble, supprimant tout l'espace vertical autour et entre les entrées.

\usepackage{enumitem}
% ...
\begin{itemize}[nosep]
  \item 詰まった項目その一
  \item 詰まった項目その二
  \item 詰まった項目その三
\end{itemize}

Un exemple concret

Enfin, un exemple qui combine ce que nous avons vu. Un itemize externe contient un interne pour créer deux niveaux, et une entrée interne a son marqueur remplacé par une flèche avec \item[$\to$].

\begin{itemize}
  \item 準備するもの
  \begin{itemize}
    \item 小麦粉
    \item[$\to$] 砂糖（任意）
    \item 塩
  \end{itemize}
  \item 手順を確認する
\end{itemize}

Dans le résultat, « Que préparer » et « Réviser les étapes » s'alignent au niveau 1 avec la puce •. La liste interne ci-dessous est de niveau 2, donc ses entrées par défaut sont le tiret – – à l'exception de la ligne « Sucre (facultatif) », où la flèche entre crochets → est mise en gras et alignée à droite, la distinguant des deux autres. Contrôler librement le marqueur et l'espacement, par entrée et par niveau, est la flexibilité que itemize vous offre.

Utilisez des puces pour organiser la prose

itemize n'est pas seulement une prose abrégée ; c'est un outil permettant de rendre comparables des éléments parallèles. Une liste dont les éléments diffèrent énormément en termes de portée, de grammaire et de longueur ne donne au lecteur aucun axe de comparaison. Utilisez des puces lorsque les éléments méritent d'être comparés côte à côte, comme les exigences du rapport, les livrables, les causes d'échec ou les contrôles de relecture.

• Gardez la grammaire des éléments parallèle. Si un élément commence par une phrase nominale, créez des phrases nominales pour tous les éléments ; si l’un est impératif, rendez tous impératifs.
• Lorsque de nombreux éléments nécessitent de longues explications, revenez aux paragraphes avec des sous-titres au lieu de puces.
• Conservez l'imbrication à environ deux niveaux. Trois niveaux ou plus sont difficiles à suivre pour les lecteurs.
• Au moment où l'ordre compte, passez de itemize à enumerate.