enumerate

enumerate est l'environnement d'une liste ordonnée — dont les éléments sont numérotés. Vous enveloppez les entrées dans \begin{enumerate} … \end{enumerate} et commencez chacune par \item. Les nombres sont générés automatiquement, et lorsque vous imbriquez les listes, le format change avec la profondeur : 1. → (a) → i. → A.. Cette page explique le fonctionnement de la numérotation automatique, le format par défaut à chaque niveau et les compteurs et commandes derrière celui-ci, le référencement croisé d'un élément, la modification du numéro de départ et le formatage facile que le package enumitem vous offre.

Utilisation de base

Dans un environnement enumerate, chaque entrée commence par \item. LaTeX attribue les numéros pour vous, vous ne tapez donc jamais « 1 ». ou « 2 ». toi-même. Tout, d'un \item au suivant (ou à \end{enumerate}) constitue le corps de cette entrée ; vous pouvez couper les lignes et les mettre en retrait librement — LaTeX aligne le numéro et le retrait à gauche. La numérotation redémarre à 1 à chaque utilisation de l'environnement.

\begin{enumerate}
  \item 材料を量る
  \item 生地を混ぜる
  \item 型に流して焼く
\end{enumerate}

Ceci définit trois entrées intitulées « 1. », « 2. » et « 3 ». en tête de chaque ligne. enumerate est un environnement LaTeX standard — aucun package requis. Lorsque vous souhaitez des marqueurs au lieu de chiffres, utilisez itemize ; pour une liste de définitions étiquetées, utilisez description. Au moins un \item est requis et vous ne pouvez pas avoir de corps de texte sans un \item initial.

Numérotation et niveaux par défaut

enumerate s'imbrique jusqu'à quatre niveaux de profondeur et le format des nombres change automatiquement avec le niveau. Dans les classes standards (article et amis), les valeurs par défaut sont : niveau 1 un chiffre arabe avec un point, 1. ; niveau 2 une lettre minuscule entre parenthèses, (a) ; niveau 3, un chiffre romain minuscule avec un point, i. ; et niveau 4 une lettre majuscule avec un point, A.. L'ouverture d'un cinquième enumerate s'arrête avec ! LaTeX Error: Too deeply nested. (et le mélange avec itemize ne lève pas cela - un plafond séparé limite toute pile de liste imbriquée à six niveaux au total).

Chaque niveau possède un compteur et deux commandes qui l'affichent. Les compteurs entiers qui effectuent le comptage sont enumi, enumii, enumiii et enumiv (les i/ii/iii/iv sont des chiffres romains désignant le niveau). La commande qui formate un compteur en texte numérique est \theenumi … \theenumiv, et la commande qui le compose comme étiquette de tête de ligne est \labelenumi … \labelenumiv. Par défaut, \theenumi, par exemple, est défini comme \arabic{enumi} (un chiffre arabe), et \labelenumi ajoute le point pour créer 1..

Pour changer uniquement le look des nombres, redéfinissez la commande de format avec \renewcommand. Les commandes qui affichent un compteur dans un style donné sont \arabic (1, 2, 3), \alph (a, b, c), \Alph (A, B, C), \roman (i, ii, iii) et \Roman (I, II, III). Par exemple, pour définir le niveau 1 comme chiffres romains majuscules I, II, III :

\renewcommand{\theenumi}{\Roman{enumi}}
\begin{enumerate}
  \item 第一の論点
  \item 第二の論点
\end{enumerate}

Désormais, le niveau 1 indique « I », « II », et ainsi de suite. Étant donné que \labelenumi est construit sur \theenumi par défaut, la redéfinition de \theenumi amène l'étiquette de tête de ligne — et le numéro renvoyé par la référence croisée \ref ci-dessous — dans le même style. Lorsque vous souhaitez également façonner la ponctuation environnante (le point ou les parenthèses), redéfinissez plutôt \labelenumi. La conception d'étiquettes de cette manière est abordée en détail sur la page «Étiquettes personnalisées».

Éléments de référencement

Vous pouvez croiser un élément d'une liste numérotée : mettez un \label{key} dans le corps du \item, puis appelez \ref{key} ailleurs pour imprimer le numéro de cet élément. Étant donné que LaTeX gère les numéros, la référence suit automatiquement la bonne valeur même si vous ajoutez ou réorganisez des éléments. Le format \ref renvoie suit la définition de la famille \theenumi de ce niveau. Pour le numéro de page, utilisez \pageref{key}.

\begin{enumerate}
  \item 仮説を立てる
  \item 実験で検証する\label{step:test}
  \item 結果をまとめる
\end{enumerate}
手順~\ref{step:test} で測定したデータを使う。

Ici, le deuxième élément porte \label{step:test}, et le \ref{step:test} de la dernière phrase se résout en « 2 ». Si vous chargez le package hyperref, cette référence devient un lien cliquable qui renvoie à l'élément. Comme d'habitude, la résolution des références nécessite généralement deux passes de compilation. Les références croisées en général sont traitées sur la page « Références croisées (\label et \ref) ».

Modification du numéro de départ

Pour démarrer la numérotation ailleurs que 1, positionnez le compteur à l'intérieur de la liste avec \setcounter. Puisque \item incrémente le compteur avant de composer l'entrée, l'astuce consiste à donner une valeur un de moins que le nombre souhaité. Pour commencer à 5, par exemple, écrivez \setcounter{enumi}{4}.

\begin{enumerate}
  \setcounter{enumi}{4}
  \item この項目は 5 番になる
  \item 6 番
\end{enumerate}

Le \item juste après \setcounter{enumi}{4} devient « 5. » et l'entrée suivante « 6. ». Pour ajuster des niveaux plus profonds, définissez enumii, enumiii ou enumiv de la même manière. Lorsque votre véritable objectif est de fermer une liste et de continuer plus tard la numérotation dans une liste séparée, le resume du package enumitem, décrit ci-dessous, est plus simple et plus fiable.

Formatage et continuation faciles avec enumitem

Lorsque vous souhaitez un contrôle précis sur le format des nombres, le package enumitem est plus propre que l'écriture manuscrite \renewcommand. Chargez-le avec \usepackage{enumitem} et vous pourrez définir le format directement avec une option label= sur l'environnement. À l'intérieur de label=, les formes étoilées \arabic*, \alph*, \Alph*, \roman* et \Roman* représentent le numéro d'article actuel. Par exemple, label=(\alph*) produit (a), (b), etc.

\usepackage{enumitem}
% ...
\begin{enumerate}[label=(\alph*)]
  \item 小文字を括弧で囲んだラベル
  \item 二つめの項目
\end{enumerate}

enumitem facilite également le démarrage et la poursuite. start= définit directement le premier nombre (pas de « soustraire un » comme avec \setcounter), et resume continue la numérotation de la liste précédente au lieu de redémarrer. Cela maintient la séquence intacte même lorsqu'un paragraphe d'explication ou un autre chiffre divise la liste.

\begin{enumerate}
  \item 最初のリストの一つめ
  \item 二つめ
\end{enumerate}
間にはさむ説明の段落。
\begin{enumerate}[resume]
  \item 番号は 3 から続く
  \item 4 番
\end{enumerate}

Avec resume, la deuxième liste continue comme « 3. », « 4. ». Vous pouvez également définir uniquement le numéro de départ, comme dans start=10, ou le combiner avec label= pour contrôler également le format. Les contrôles d'espacement, les listes en ligne et les étiquettes de référence ajoutés par enumitem sont rassemblés sur la page « enumitem ».

Un exemple concret

Enfin, un exemple qui combine ce que nous avons vu. Nous construisons une liste d'étapes, attachons un \label à l'une d'elles et faisons référence à son numéro en dehors de la liste avec \ref. Étant donné que LaTeX est propriétaire de la numérotation, la référence suit automatiquement même si vous réorganisez les étapes.

実験は次の手順で進める。
\begin{enumerate}
  \item サンプルを室温に戻す
  \item 重量を記録する\label{step:weigh}
  \item 溶媒を加えて撹拌する
  \item 一晩静置する
\end{enumerate}
手順~\ref{step:weigh} の値を、最終的な収率の計算に用いる。

Dans la sortie, les quatre étapes numérotées « 1 » s'alignent. en passant par « 4 ». Le deuxième, « Enregistrez le poids », porte \label{step:weigh}, donc le \ref{step:weigh} dans la phrase après la liste se résout en « 2 », indiquant « la valeur de l'étape 2… ». Si vous insérez ultérieurement « Inspecter l'appareil » comme nouvelle première étape, la cible passe à la troisième - mais \ref se met automatiquement à jour à « 3 ». C'est le principal avantage de laisser LaTeX numéroter à votre place au lieu de taper les chiffres à la main.

Écrire des éléments numérotés comme étapes référencées

Utilisez enumerate non pas parce que les nombres sont jolis, mais parce que l'ordre, la priorité ou les références doivent rester stables. Lorsque la liste est un ensemble d’étapes référencées, ne saisissez pas les chiffres dans la prose ; attachez \label aux éléments qui comptent. Si des paragraphes ou des figures explicatives interrompent la procédure, le resume de enumitem maintient la séquence continue et empêche la dérive de la numérotation après les modifications.

• Procédures : utilisez enumerate ; la capacité de dire « retour à l’étape 3 » est la valeur.
• Conditions non ordonnées : utilisez itemize ; la numérotation d'une liste non ordonnée suggère faussement une priorité ou une chronologie.
• Éléments référencés : joignez \label et citez-les avec \ref. Les nombres tapés à la main invitent à des erreurs de vérification.
• Procédures interrompues : continuez-les avec resume afin que les blocs de liste séparés soient toujours lus comme une seule séquence.