알고리즘과 소스 코드 목록
의사코드 스케치용 algorithm2e와 실제 코드용 listings.
알고리즘과 소스 코드 목록
논문은 코드를 두 가지 형태로 보여 주며, LaTeX는 각각에 다른 도구를 갖추고 있습니다. 의사코드는 알고리즘을 이상화한 스케치로, 키워드와 수식으로 조판하며 algorithm2e 패키지가 처리합니다. 소스 목록은 실제 코드를 고정폭 글꼴로 있는 그대로 옮긴 것이며 listings 패키지가 처리합니다. 잘못된 도구를 고르는 것이 마찰의 흔한 원인이므로, 둘 다 살펴보면 도움이 됩니다.
algorithm2e로 의사코드 쓰기
\usepackage[ruled,vlined]{algorithm2e}\begin{algorithm}\caption{Train}\While{not converged}{ Update $\theta$\;}\end{algorithm}패키지 옵션이 시각적 스타일을 정합니다. ruled는 알고리즘 위아래에 가로선을 긋고 캡션을 위쪽에 두는데, 대부분의 투고처가 기대하는 관례입니다. vlined는 각 블록의 범위를 나타내는 작은 세로선을 그어, 들여쓰기를 크게 하지 않고도 중첩을 읽기 쉽게 합니다. algorithm 환경은 그림처럼 플로트이므로 \caption을 가지며, 이 캡션이 \ref가 인용할 번호를 부여합니다.
안쪽에서는 \While{condition}{body}가 굵은 키워드, 조건, 들여쓴 블록으로서의 본문으로 반복문을 조판합니다. \For, \If, \Return도 같은 패턴을 따릅니다. 문장은 \;로 끝나며, 이는 줄의 종결 기호를 출력하고 새 줄을 시작합니다. 이를 빠뜨리는 것이 전형적인 초보자 실수로, 줄들이 서로 이어 붙어 버립니다. 일반 LaTeX이므로 $\theta$ 같은 수식도 인라인으로 쓸 수 있으며, 의사코드는 바로 이를 위한 것입니다. 특정 언어가 아니라 표기법으로 갱신 규칙을 기술하는 것입니다.
listings로 실제 코드 쓰기
\usepackage{listings}\begin{lstlisting}[language=Python]def f(x): return x**2\end{lstlisting}lstlisting 환경은 내용을 정확히 그대로 재현하며, 공백을 보존하고 특수 문자를 문자 그대로 다루므로, 아무것도 이스케이프하지 않고 코드를 붙여 넣을 수 있습니다. language=Python 옵션은 해당 언어의 키워드 강조를 켜며, listings는 다른 수십 가지 언어도 압니다. 기본 출력은 밋밋합니다. 대부분은 프리앰블에 \lstset{basicstyle=\ttfamily\small, numbers=left}를 한 번 넣어, 적당한 크기의 고정폭 글꼴과 줄 번호를 얻습니다. 붙여 넣는 대신 파일을 직접 포함하려면 \lstinputlisting[language=Python]{train.py}가 디스크에서 읽어 오므로 논문이 실제 소스와 동기화됩니다. 색이 있는 고품질 강조가 필요하다면 minted 패키지가 더 강력한 대안이지만, 외부 도구와 셸 이스케이프가 필요하다는 대가가 따릅니다.
둘 중에서 고르기
논문 본문에서는 아이디어를 전달하기 위해 의사코드를 쓰고, 부록이나 도구 설명처럼 정확한 코드가 중요한 산출물에만 있는 그대로의 목록을 쓰세요. 흔한 실수는 Beamer 프레임 안에 [fragile] 옵션 없이 lstlisting을 넣는 것으로, 알 수 없는 오류와 함께 실패합니다. 첫 번째 Beamer 덱에도 같은 주의가 나옵니다.