Étiquettes personnalisées

Vous pouvez modifier le marqueur (ou étiquette) en tête de chaque entrée de liste. Transformez la puce de itemize en diamant ou en « 1 ». de enumerate dans le « I » romain. ou "(a)" - la clé est une poignée de macros fournies par niveau. Cette page couvre à la fois l'itinéraire classique via \renewcommand (itemize's \labelitemi et enumerate's \theenumi et \labelenumi) et la clé moderne et plus simple label= de enumitem, montrant en quoi elles diffèrent et quand les atteindre.

Modification des marqueurs d'élément

itemize se trouvent dans les macros \labelitemi, \labelitemii, \labelitemiii et \labelitemiv, un par niveau d'imbrication (les i / ii / iii / iv sont des chiffres romains pour les niveaux 1 à 4). Dans les classes standard, les valeurs par défaut sont : niveau 1 une puce pleine \textbullet (•), niveau 2 un tiret gras (–), niveau 3 un astérisque \textasteriskcentered (*) et niveau 4 un point centré \textperiodcentered (·).

Pour changer le marqueur de un niveau entier, redéfinissez la macro correspondante avec \renewcommand, placée en préambule ou juste avant le scope là où vous le souhaitez. Par exemple, pour faire du premier niveau un diamant :

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

Pour modifier le marqueur pour une seule entrée, donnez une étiquette entre crochets juste après \item. \item[$\star$] fait du marqueur de cette entrée une étoile et \item[--] un tiret. Une étiquette entre crochets comme celle-ci est définie en gras et à droite par défaut.

énumérer les nombres — le compteur et \theenumi

enumerate est un cran plus impliqué. Sa numérotation est pilotée par un compteur par niveau : enumi, enumii, enumiii, enumiv. La façon dont la valeur de chaque compteur (1, 2, 3 …) est représentée est décidée par \theenumi, \theenumii, et ainsi de suite, dont les valeurs par défaut dans les classes standard sont :

Pour définir le premier niveau en chiffres romains, redéfinissez \theenumi avec \Roman. Parce que \theenumi est également la chaîne produite lorsque vous \ref un tel élément, sa modification met à jour le numéro imprimé et la référence croisée ensemble (plus d'informations sur les références ci-dessous).

\renewcommand{\theenumi}{\Roman{enumi}}
\begin{enumerate}
  \item 第一段階（既定では I. と表示）
  \item 第二段階
\end{enumerate}

\labelenumi contre \theenumi

C'est le point crucial. Où \theenumi corrige la représentation du nombre (1 vs I vs a), les macros \labelenumi, \labelenumii, … ​​corrigent la manière dont l'étiquette est imprimée en tête de ligne. \labelenumi appelle \theenumi en interne et l'entoure de signes de ponctuation (un point ou des parenthèses). Les valeurs par défaut de la classe standard ci-dessous ajoutent un point partout sauf au niveau 2, qui est entre parenthèses :

Ainsi, lorsque vous souhaitez modifier uniquement l'apparence de l'étiquette (en laissant la représentation du numéro seule), redéfinissez \labelenumi. Pour tourner « 1 ». dans « (1) », par exemple, écrivez ce qui suit. Puisque \theenumi n'est pas modifié, un \ref à l'élément donne toujours un simple 1 sans parenthèses.

\renewcommand{\labelenumi}{(\theenumi)}
\begin{enumerate}
  \item 行頭は (1) と表示される
  \item (2)、(3) と続く
\end{enumerate}

En bref : l'apparence du nombre (I, a, 1) est \theenumi ; le style général de l'étiquette (parenthèses ou point environnants) est \labelenumi. La valeur de référence croisée utilise la représentation nue dans \theenumi sans la ponctuation de l'étiquette — plus précisément, LaTeX construit la référence en préfixant \theenumi avec \p@enumi (vide par défaut). Définissez \p@enumii et amis et vous pouvez faire des références qui incluent le numéro de parent, comme « 1(a) ».

Commandes de contre-représentation

Pour choisir l'apparence d'un nombre à l'intérieur de \theenumi ou \labelenumi, utilisez les commandes de contre-représentation standard de LaTeX. Chacun prend un nom de compteur comme argument (par exemple \Roman{enumi}) et imprime la valeur de ce compteur sous la forme choisie.

\alph et \Alph erreurs au-delà de 26 et \fnsymbol erreurs en dehors de 1 à 9. Par exemple, \renewcommand{\theenumi}{\Alph{enumi}} définit le premier niveau sur A, B, C…, tandis que \renewcommand{\labelenumi}{\arabic{enumi})} donne une étiquette comme « 1) ».

La méthode moderne et simple — enumitem's label=

La redéfinition des macros est puissante, mais cela devient compliqué lorsque vous souhaitez un style différent par liste. Dans la plupart des cas, le package enumitem est plus propre, alors commencez par le récupérer. Chargez enumitem et vous pourrez définir l'étiquette d'une liste directement dans son argument facultatif avec label=.

À l'intérieur de label=, vous utilisez les commandes de représentation étoilées — \alph*, \Alph*, \arabic*, \roman*, \Roman* — qui ne prennent aucun argument et représentent le compteur du niveau actuel. Vous écrivez la ponctuation à côté, donc label=(\alph*) donne « (a) » et label=\Roman*. donne « I ».

\usepackage{enumitem}
% ...
\begin{enumerate}[label=(\alph*)]
  \item ラベルは (a) になる
  \item (b)、(c) と続く
\end{enumerate}

Cela fonctionne également pour itemize — \begin{itemize}[label=$\star$] donne directement le marqueur. Par défaut, label= définit également la forme de la référence croisée (\ref), mais lorsque vous souhaitez que la référence ait une forme différente, utilisez la touche ref=. Par exemple, [label=(\alph*), ref=\alph*] imprime « (a) » en tête tandis que \ref renvoie un « a » nu. Il existe également label*=, qui s'ajoute à l'étiquette parent pour créer des nombres accumulés tels que 1., 1.1., 1.1.1. … Notez que label*= ne s'accumule que pour l'étiquette imprimée : le numéro parent n'est pas ajouté automatiquement aux références croisées, donc pour obtenir une référence comme « 1.a », vous devez l'épeler avec ref=, par ex. ref=\theenumi.\alph*.

Pour appliquer le même style à chaque liste du document, définissez-la une fois avec \setlist, en nommant le genre (itemize / enumerate) et le niveau entre crochets.

\usepackage{enumitem}
\setlist[enumerate,1]{label=\Roman*.}   % 第1階層を I. II. III.
\setlist[enumerate,2]{label=(\alph*)}    % 第2階層を (a) (b)
\setlist[itemize,1]{label=$\diamond$}    % itemize 第1階層を菱形に

Avec l'option shortlabels de enumitem, vous pouvez également utiliser la syntaxe laconique de style package enumerate telle que \begin{enumerate}[(1)]. Un travail de compteur plus fin par niveau et des listes en ligne sont abordés plus loin sur la page enumitem.

Un exemple concret

Enfin, voici tout dans un seul document. La première mi-temps utilise la voie classique pour donner au plus haut niveau un « I » romain. style; le second arrive laconiquement au même résultat avec enumitem de label=. Les deux produisent un résultat identique.

% --- 古典的な方法 / the classic way ---
\renewcommand{\theenumi}{\Roman{enumi}}
\renewcommand{\labelenumi}{\theenumi.}
\begin{enumerate}
  \item 下ごしらえ        % I. と表示
  \item 加熱する          % II.
\end{enumerate}

% --- enumitem を使う / with enumitem ---
\usepackage{enumitem}
\begin{enumerate}[label=\Roman*.]
  \item 下ごしらえ        % I.
  \item 加熱する          % II.
\end{enumerate}

Dans la première moitié, \theenumi est défini sur \Roman pour changer la représentation en I, II, …, puis \labelenumi est défini comme \theenumi. pour ajouter le point (la valeur par défaut \labelenumi est déjà \theenumi., donc cette ligne rend simplement le style explicite). Dans la seconde moitié, le single label=\Roman*. fait les deux tâches à la fois. Pour le travail quotidien, ce formulaire enumitem suffit ; ce n'est que lorsque vous devez gérer l'étiquette et la référence séparément que vous revenez à \theenumi, \labelenumi et ref=.