문서의 구조: 도입

요약

이 수업은 문서의 구조를 다루는 이 강좌의 셋째 단원을 연다. 단원이 무엇을 위한 것인지 설명한다. 곧 앞 단원에서 잘 조판한 본문에서 출발하여, 고유한 골격을 갖춘 긴 문서로 나아가는 것이다. 그런 문서에서는 각 부분에 번호가 붙고, 차례에 실리고, 서로를 참조하며, 여러 파일로 나뉜다. 또한 단원의 다섯 수업과, 문서 클래스와 쪽에서 자신만의 프리앰블까지 그것들을 잇는 실마리를 소개하고, 앞 단원들에서 무엇을 전제하는지 밝히며, 학술 문서의 형식이 어디에서 왔는지 돌아본다. 그리고 단원이 해결하는 문제, 곧 참조와 번호를 손으로 쓴 문서는 바뀌는 순간 거짓말을 하기 시작한다는 문제를 제기하고, 이 골격이 물리학 학위 논문에도 역사학 학위 논문에도 똑같이 쓸모 있음을 보인다.

학습 목표

단원 내용의 순서를 서술하고, 각 수업이 다음 수업에 무엇을 보태는지 설명한다.
단원이 앞 단원들에서 전제하는 것을 알아보고, 필요하면 복습한다.
내부 참조를 손으로 쓰지 않는 까닭을 예를 들어 설명한다.
여러 분야의 학술 장르에서 단원이 조판하는 법을 가르치는 구조를 알아본다.

시작 평가

단원을 공부하기 전에 출발점을 재어 보는 것이 좋다. 이 평가는 자기 평가이다. 점수를 매기지 않으며, 공부의 방향을 잡는 것만이 목적이다. 처음 두 문항은 단원이 앞 단원들에서 전제하는 내용을 복습하고, 이어지는 열 문항은 두 문항씩 차례로 단원의 다섯 수업을 다룬다. 긴 문서를 조판해 본 적이 없는 사람은 맞히리라 기대하지 않아도 된다. 모든 답은 맞든 틀리든 요점을 설명하고 그것을 다루는 수업의 이름을 알려 준다. 같은 기능은 마지막 종합 수업에서 다시 잰다.

입문 평가

단원을 시작하기 전에 출발점을 확인해 보세요. 짧은 자기 평가입니다. 점수가 매겨지지 않으며 결과는 브라우저에만 저장됩니다.

문제 1이전 단원에서문서를 처음 컴파일한 뒤 \ref로 쓴 참조가 물음표 두 개로 나타나고, 로그는 한 번 더 컴파일하라고 한다. 무슨 일이 일어난 것인가?
첫 번째 패스에서 엔진은 번호를 보조 파일에 적었지만, 그것을 쓸 수 있는 것은 다음 패스부터이다. 한 번 더 컴파일하거나 latexmk로 컴파일하면 된다.
레이블의 철자가 틀렸으므로 고쳐야 한다.
참조를 위한 패키지가 빠졌다.
보조 파일이 손상되었으므로 지워야 한다.
문제 2이전 단원에서어떤 에세이는 작품 제목을 쓸 때마다 겹낫표를 손으로 치는 대신, 프리앰블에서 \newcommand{\jakpum}[1]{『#1』}로 정의한 \jakpum{…}으로 표시한다. 무엇을 얻는가?
모든 제목의 모양을 한 줄로 바꿀 수 있으며, 다른 기능을 하는 부호나 글꼴은 건드리지 않는다. 예컨대 제목을 이탤릭체로 쓰라는 서양어 학술지에 투고할 때이다.
아무것도 얻지 못한다. 결과가 같기 때문이다.
컴파일이 빨라진다.
제목이 저절로 차례에 들어간다.
문제 3한 학생이 \documentclass{article}로 학위 논문을 쓰면서 본문을 \chapter{…}로 나누었다. 컴파일하면 어떻게 되는가?
엔진이 「Undefined control sequence」 오류를 낸다. article 클래스에는 장이 없기 때문이다.
장이 절로 조판된다.
장이 제대로 조판된다. 모든 클래스의 구획 단계가 같기 때문이다.
아무 경고 없이 무시된다.
문제 4어느 대학이 A4 용지에 2.5센티미터의 여백을 요구한다. 그 여백을 정하는 알맞은 방법은 무엇인가?
geometry 패키지를 쓴다. 예를 들어 프리앰블에 \usepackage[a4paper, margin=2.5cm]{geometry}라고 쓴다.
여백을 정해 주는 클래스 옵션 a4paper를 쓴다.
줄마다 맨 앞에 \hspace를 쓴다.
\small로 글자 크기를 줄인다.
문제 5article 클래스의 문서에서 \tableofcontents 앞에 \setcounter{tocdepth}{1}을 썼다. 차례에는 무엇이 나타나는가?
절만 나타나고 소절은 나타나지 않는다.
소절만 나타난다.
아무것도 나타나지 않는다. 차례가 비기 때문이다.
모든 구획이 나타나지만 번호가 없다.
문제 6article 클래스의 문서에서 \appendix 명령 뒤에 \section을 두 개 썼다. 번호는 어떻게 붙는가?
문자로, A와 B가 붙는다.
보통의 절처럼 앞의 번호가 이어진다.
별표 붙은 절처럼 번호가 없다.
로마 숫자로, I과 II가 붙는다.
문제 7한 저자가 제2절인 \section{방법} 앞의 줄에 \label{sec:methods}를 썼다. \ref{sec:methods}는 어떤 번호를 인쇄하는가?
앞 구획의 번호인 1을 인쇄한다. 레이블은 자기보다 앞에 마지막으로 매겨진 번호를 받기 때문이다.
2를 인쇄한다. 레이블이 절 바로 옆에 있기 때문이다.
컴파일할 때마다 물음표 두 개를 인쇄한다.
레이블은 제목 안에 써야 하므로 오류가 난다.
문제 8hyperref 패키지를 불러오면 문서에서 무엇이 바뀌는가?
참조, 차례의 항목, 각주 표시가 PDF의 링크가 되고, PDF에 책갈피가 생긴다.
절과 쪽의 번호.
참조에 두 번의 패스가 더는 필요 없다.
「차례」나 「그림」 같은 이름의 언어.
문제 9학위 논문의 주 문서에서 \include{chapter1}와 \input{chapter1}는 무엇이 다른가?
\include는 내용을 새 쪽에서 시작하고, \includeonly로 일부 장만 컴파일할 수 있게 한다. \input은 파일을 쓴 자리에 그대로 끼워 넣는다.
아무것도 다르지 않다. 동의어이다.
\input은 프리앰블용 파일만 받는다.
\include는 저장할 때 파일을 주 문서 안으로 복사한다.
문제 10학위 논문의 프리앰블에 \includeonly{chapter3}가 있고, 본문은 다섯 장을 \include로 포함한다. 논문 전체를 전에 이미 컴파일한 적이 있다면, 이번 컴파일은 무엇을 만드는가?
제3장만 담은 PDF를 만든다. 쪽, 장, 참조의 번호는 그대로이며, 그 번호는 다른 장들의 보조 파일에서 가져온다.
다섯 장을 모두 담은 PDF를 만든다. \includeonly는 차례에만 영향을 주기 때문이다.
제3장만 담은 PDF를 만들되, 제1장으로 번호가 붙고 1쪽에서 시작한다.
다른 장이 없으므로 오류가 난다.
문제 11프리앰블에 \newcommand{\emph}[1]{\textbf{#1}}가 있다. 어떻게 되는가?
엔진이 「Command \emph already defined」 오류를 낸다. \newcommand는 이미 있는 명령을 다시 정의하지 않으며, 그 일을 위해 \renewcommand가 있다.
모든 강조가 굵은 글꼴이 된다.
두 번째 \emph가 만들어져 원래 명령과 함께 있게 된다.
아무 일도 없다. 프리앰블은 글자를 조판하지 않기 때문이다.
문제 12프리앰블에 \newcommand{\yang}[2]{#1~#2}가 있을 때 \yang{5}{km}는 무엇을 인쇄하는가?
「5 km」를 인쇄한다. 그 사이의 공백에서는 줄을 나눌 수 없다.
「km 5」를 인쇄한다.
「5~km」를 인쇄하며, 물결표가 찍힌다.
명령은 인수를 하나만 받으므로 오류가 난다.