description

description ist die Umgebung für Definitionslisten – Paare eines Begriffs und seiner Erklärung. Geben Sie jedem \item ein optionales Argument [...] und sein Inhalt wird zum Begriff (Beschriftung), standardmäßig fett gedruckt am linken Rand, mit der folgenden Erklärung. Es ist ideal für Glossare, Optionslisten und Parameterdokumentation.

Grundlegende Verwendung

Wo itemize und enumerate die Bezeichnung für Sie liefern (ein • oder 1.), ist description anders: Sie geben die Bezeichnung in Worten an. Die Bezeichnung steht im optionalen Argument [...] von \item. In itemize und enumerate ist [...] ein Extra zum Überschreiben der Markierung eines Elements; in description ist es praktisch der springende Punkt.

\begin{description}
  \item[TeX] クヌースが作った組版システム。
  \item[LaTeX] TeX 上に築かれた文書作成のための言語。
  \item[CTAN] パッケージを配布する世界規模のアーカイブ網。
\end{description}

Schriftsatz, die Wörter TeX, LaTeX und CTAN stehen in Fettdruck am linken Rand, jeweils gefolgt von ihrer Erklärung auf der rechten Seite (bei Länge wird in die nächste Zeile umgebrochen). Wenn eine Beschriftung lang ist, beginnt die erste Zeile der Erklärung direkt danach. Wie bei itemize und enumerate benötigen Sie mindestens ein Element; Null Elemente lösen den Fehler „Something's wrong--perhaps a missing \item“ aus.

Kennzeichnen Sie Fallstricke

Wenn Sie [...] weglassen, erhält das Element keine Beschriftung (Sie erhalten einen Eintrag im Stil eines hängenden Absatzes ohne Markierung und ohne Einzugshinweis). Da die Bezeichnung der Sinn von description ist, vermeiden Sie dies, es sei denn, es ist absichtlich. In der offiziellen LaTeX-Referenz wird empfohlen, immer eine Bezeichnung anzugeben, „da es keine sinnvolle Vorgabe gibt.“

Die andere Falle sind eckige Klammern. Da [ und ] das optionale Argument begrenzen, verstecken Sie diese in geschweiften Klammern, wenn Sie eine wörtliche Klammer *als Zeichen* in einer Beschriftung oder im Textkörper haben möchten. Wenn der Text mit [ beginnt, schreiben Sie \item {[}; und um eine schließende Klammer in eine Beschriftung einzufügen, klammern Sie sie als {]} ein, z. B. \item[Close bracket, {]}].

\begin{description}
  \item[\texttt{[a-z]}] 文字クラス。ラベル内の角括弧は中括弧で保護する。
  \item {[}本文が角括弧で始まる場合はこう書く。
\end{description}

Außerdem überschreibt ein Befehl zum Ändern der Schriftart, der in Deklarationsform in einer Beschriftung geschrieben ist, die Standardfettschrift. Um beispielsweise eine Beschriftung im Monospace festzulegen, schließen Sie das Ganze aus Sicherheitsgründen in geschweifte Klammern ein – \item[{\ttfamily label}].

Customizing mit enumitem

Um die Schriftart und Platzierung des Begriffs zu optimieren, verwenden Sie das Paket enumitem. Damit können Sie Optionen direkt an die description Umgebung übergeben: font= legt die Beschriftungsschriftart fest, leftmargin= den linken Einzug und style= wie die Beschriftung und der Text angeordnet sind. Auch mit anderen Listen geteilte Schlüssel, wie z. B. itemsep=, funktionieren hier.

\usepackage{enumitem}

\begin{description}[font=\bfseries\sffamily, style=nextline, leftmargin=1cm]
  \item[オプション] 長いラベルは次の行から本文が始まる。
  \item[既定値] サンセリフ体の太字でラベルを組む。
\end{description}

Der Schlüssel style= nimmt diese Hauptwerte an. In description beginnt die Beschriftung immer links, aber sie unterscheiden sich darin, wie der Körper verläuft, wenn die Beschriftung lang ist.

Um die gleichen Einstellungen auf alle description anzuwenden, schreiben Sie einmal \setlist[description]{...} in die Präambel. Beispielsweise gilt \setlist[description]{font=\sffamily\bfseries, style=nextline} für alle Definitionslisten im Dokument gleichzeitig. Auch leftmargin= und labelsep= sind wissenswert: Ersteres macht den Anfang des Körpers vom Etikett abhängig, während letzteres die Lücke zwischen Etikett und Körper festlegt.

Fettschrift ändern (\descriptionlabel)

Wenn Sie lieber nur die Standardfettschrift ohne enumitem ändern möchten, definieren Sie \descriptionlabel – den Befehl, der jede Beschriftung festlegt – mit \renewcommand neu. Sein Argument #1 ist der Beschriftungstext. Hier ist ein Beispiel, das jede Beschriftung in Kleinbuchstaben setzt (der \hspace{\labelsep} fügt die übliche Lücke zwischen Beschriftung und Text hinzu).

\renewcommand{\descriptionlabel}[1]{%
  {\hspace{\labelsep}\textsc{#1}}}

Fügen Sie diese Neudefinition in die Präambel ein und jedes nachfolgende description-Label wird in Kapitälchen gesetzt. Tauschen Sie \textsc gegen \texttt (Monospace) oder \textit (kursiv) aus, um das gewünschte Aussehen zu erhalten. Beachten Sie, dass itemize seine Markierung durch •→–→*→· mit Verschachtelungstiefe zyklisch durchläuft und enumerate 1.→(a)→i.→A. durchläuft, description auf jeder Verschachtelungsebene den gleichen Etikettenstil beibehält – Es gibt nur einen \descriptionlabel, daher gilt eine Neudefinition einheitlich für alle Ebenen im Dokument.

Ein ausgearbeitetes Glossar

Für den praktischen Gebrauch finden Sie hier ein kleines Glossar mit enumitem. style=nextline fügt lange Begriffe in eine eigene Zeile ein, font=\bfseries macht Fettschrift explizit und leftmargin= rückt die Erklärungen sauber ein. Jeder \item trägt seinen Begriff in [...] gefolgt von der Erklärung.

\documentclass{article}
\usepackage{enumitem}
\begin{document}

\begin{description}[font=\bfseries, style=nextline, leftmargin=1.5cm]
  \item[コンパイル]
    ソースファイルを TeX エンジンで処理し、PDF などの出力を得ること。
  \item[プリアンブル]
    \verb|\documentclass| から \verb|\begin{document}| までの設定部分。
  \item[相互参照]
    \verb|\label| と \verb|\ref| により、番号やページを自動で挿入するしくみ。
\end{description}

\end{document}

Schriftsatz ergibt ein lesbares Glossar: Die drei Begriffe „Kompilieren“, „Präambel“ und „Querverweis“ stehen jeweils in Fettschrift in einer eigenen Zeile, wobei die Erklärung 1,5 cm darunter eingerückt ist. Wenn Ihre Begriffe kurz sind, lassen Sie style=nextline weg und lassen Sie die Erklärung stattdessen in derselben Zeile beginnen.