description

description은 정의 목록(용어와 설명의 쌍)을 위한 환경입니다. 각 \item에 선택적 인수 [...]을 제공하면 해당 내용이 용어(레이블)가 되며 기본적으로 왼쪽 여백에 굵게 표시됩니다. 설명은 다음과 같습니다. 용어집, 옵션 목록 및 매개변수 문서화에 이상적입니다.

기본 사용법

itemize 및 enumerate이 레이블을 제공하는 경우(• 또는 1.), description은 다릅니다. 레이블을 단어로 제공합니다. 레이블은 \item의 선택적 인수 [...]에 들어갑니다. itemize 및 enumerate에서 [...]은 한 항목의 마커를 재정의하기 위한 추가 항목입니다. description에서는 이것이 사실상 핵심입니다.

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

활자체, TeX, LaTeX 및 CTAN라는 단어는 왼쪽 여백에 굵게 표시되어 있으며 각 단어 뒤에는 오른쪽에 설명이 옵니다(긴 경우 다음 줄로 줄 바꿈). 레이블이 길면 설명의 첫 번째 줄이 레이블 바로 뒤에서 시작됩니다. itemize 및 enumerate과 마찬가지로 항목이 하나 이상 필요합니다. 항목이 0개이면 “Something's wrong--perhaps a missing \item” 오류가 발생합니다.

라벨의 함정

[...]을 생략하면 해당 항목에 라벨이 표시되지 않습니다(마커와 들여쓰기 신호가 없는 내어쓰기 스타일 항목이 표시됩니다). 레이블은 description의 요점이므로 고의가 아닌 이상 이를 피하세요. 공식 LaTeX 참조에서는 "합리적인 기본값이 없기 때문에" 항상 레이블을 제공할 것을 권고합니다.

다른 트랩은 대괄호입니다. [ 및 ]은 선택적 인수를 구분하기 때문에 레이블이나 본문에서 리터럴 대괄호를 *문자로* 사용하려는 경우 이를 중괄호로 숨깁니다. 본문이 [로 시작하는 경우 \item {[}을 쓰고, 레이블 안에 닫는 괄호를 넣으려면 {]}으로 중괄호를 지정하세요. \item[Close bracket, {]}].

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

또한 라벨 내부의 선언 양식에 작성된 글꼴 변경 명령은 기본 굵은 글꼴을 재정의합니다. 예를 들어 고정 폭으로 레이블을 설정하려면 안전을 위해 전체를 중괄호(\item[{\ttfamily label}])로 묶습니다.

enumitem으로 사용자 정의

용어의 글꼴과 배치를 미세 조정하려면 enumitem 패키지를 사용하세요. description 환경에 옵션을 직접 전달할 수 있습니다. font=은 레이블 글꼴을 설정하고, leftmargin= 왼쪽 들여쓰기를 설정하고, style= 레이블과 본문이 정렬되는 방식을 설정합니다. itemsep= 등 다른 목록과 공유되는 키도 여기에서 작동합니다.

\usepackage{enumitem}

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

style= 키는 이러한 기본 값을 사용합니다. description에서는 레이블이 항상 왼쪽에서 시작하지만 레이블이 길면 본문이 흐르는 방식이 다릅니다.

모든 description에 동일한 설정을 적용하려면 머리말에 \setlist[description]{...}을 한 번만 입력하세요. 예를 들어 \setlist[description]{font=\sffamily\bfseries, style=nextline}은 문서의 모든 정의 목록에 동시에 적용됩니다. leftmargin= 및 labelsep=도 알아 둘 가치가 있습니다. 전자는 본문의 시작을 레이블에 따라 달라지게 하고, 후자는 레이블과 본문 사이의 간격을 수정합니다.

굵게 변경(\descriptionlabel)

enumitem 없이 기본 굵은 글씨만 변경하려면 \renewcommand으로 각 레이블을 설정하는 명령인 \descriptionlabel을 재정의하세요. #1 인수는 레이블 텍스트입니다. 다음은 모든 레이블을 작은 대문자로 설정하는 예입니다(\hspace{\labelsep}은 레이블과 본문 사이에 일반적인 간격을 추가합니다).

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

이 재정의를 서문에 넣으면 이후의 모든 description 레이블이 작은 대문자로 설정됩니다. \textsc을 \texttt(고정폭) 또는 \textit(이탤릭체)로 바꿔 원하는 모양을 얻으세요. itemize은 중첩 깊이가 있는 •→–→*→·을 통해 마커를 순환하고 enumerate은 1.→(a)→i.→A.을 순환하지만 description은 모든 중첩 수준에서 동일한 레이블 스타일을 유지합니다 — 하나만 있습니다. \descriptionlabel, 따라서 재정의는 문서의 모든 수준에 균일하게 적용됩니다.

잘 정리된 용어집

실용적인 사용을 위해 enumitem으로 장식된 작은 용어집이 있습니다. style=nextline은 긴 용어를 한 줄에 넣고, font=\bfseries은 굵은 글씨를 명시적으로 만들고, leftmargin=은 설명을 깔끔하게 들여쓰기합니다. 각 \item은 [...]에 해당 용어와 설명이 포함됩니다.

\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}

활자체를 사용하면 읽을 수 있는 용어집이 생성됩니다. "컴파일", "서문" 및 "상호 참조"라는 세 용어는 각각 한 줄에 굵은 글씨로 표시되며 설명은 아래에 1.5cm 들여쓰기되어 있습니다. 용어가 짧으면 style=nextline을 삭제하고 대신 같은 줄에서 설명을 시작하세요.