약어 및 기호 목록
glossaries-extra 스케치, 그리고 그것으로 충분할 때 쓰는 직접 만든 목록.
약어 및 기호 목록
긴 문서에는 약어가 쌓이고, 약어에 관한 관례는 엄격합니다. 약어는 처음 쓸 때 전체 이름을 풀어 쓰고 그 뒤로는 줄여 쓰며, 학위논문에는 보통 앞부분에 약어 목록이 필요합니다. 이를 손으로 관리하면 예측 가능한 방식으로 실패합니다. 두 장의 순서를 바꾸면 처음 쓰는 위치가 옮겨지고, 갑자기 “machine learning (ML)“보다 세 쪽 앞에 “ML”이 나타납니다. glossaries-extra 패키지는 처음 쓰는 위치를 대신 추적해 줍니다.
자동화된 방법
\usepackage[acronym]{glossaries-extra}\makeglossaries\newacronym{ml}{ML}{machine learning}acronym 옵션은 약어 지원을 켜고, \makeglossaries는 컴파일 중에 항목을 수집하는 장치를 켭니다. \newacronym은 인수를 세 개 받습니다. 본문에서 입력할 키, 줄임말, 그리고 풀어 쓴 이름입니다. 이들은 모두 프리앰블이나 \input으로 불러오는 별도 파일에 정의해서 한곳에 모아 두세요.
본문에서는 약어 자체를 직접 입력하지 않습니다.
\gls{ml} on first use expands; later uses stay short.\printglossaries문서에서 처음 나오는 \gls{ml}은 “machine learning (ML)“을 출력하고, 그 이후의 \gls{ml}은 모두 “ML”만 출력합니다. 패키지가 소스 안의 위치가 아니라 사용 순서를 추적하기 때문에, 구조를 바꿔 처음 쓰는 곳이 어디로 옮겨져도 풀어 쓴 이름이 그 위치를 따라갑니다. \printglossaries는 놓은 자리에 수집된 약어 목록을 출력하며, 보통 목차 뒤에 놓습니다. 관련 명령으로 문법을 처리합니다. 복수형에는 \glspl, 문장 첫머리의 대문자 표기에는 \Gls를 씁니다.
함정은 빌드에 있습니다. LaTeX 실행 사이에 makeglossaries 도우미가 실행되어 항목을 정렬하고 서식을 맞춰야 하며, 그렇지 않으면 \printglossaries가 아무 말 없이 아무것도 출력하지 않습니다. 완전한 latexmk 설정은 이를 자동으로 처리합니다. 더 단순한 파이프라인은 그렇지 않을 수 있고, glossaries-extra는 그런 경우를 위한 대체 방법을 제공합니다. 목록이 끝까지 나타나지 않는다면 문서의 버그보다 먼저 도우미 실행 누락을 의심하세요.
직접 만드는 방법
기호 목록이 단순하다면 직접 관리하는 description 환경으로도 충분한 경우가 많습니다.
\section*{Notation}\begin{description} \item[$\eta$] learning rate \item[$\theta$] model parameters\end{description}각 \item[...]은 대괄호 인수를 굵은 레이블로 출력하고 설명이 뒤따르며, 이것이 바로 기호 목록의 모양입니다. 처음 쓰는 위치를 추적하는 기능은 없지만, 기호 목록에는 그런 기능이 거의 필요하지 않습니다. 기호는 수식에 처음 나오는 곳에서 어차피 정의되기 때문입니다.
솔직한 조언은 규모에 맞는 도구를 고르라는 것입니다. 약어가 다섯 개인 논문은 손으로 관리하는 편이 쉽습니다. 약어가 마흔 개인 200쪽짜리 학위논문은 그렇지 않으며, 그런 경우에는 패키지의 설정 비용이 몇 배로 보상됩니다. description 환경은 목록 레슨에서 더 자세히 다룹니다.