여러 파일로 된 프로젝트
프리앰블과 \begin{document}는 main.tex에 두고, 다른 파일은 \input{chapters/intro} 또는 \include{chapters/intro}로 불러오세요. Scissor LaTeX는 조판하기 전에 이 파일들을 하나의 문서로 합칩니다.
문서를 나누는 이유
학위 논문이나 긴 보고서는 나누어 작업하는 편이 쉽습니다. 장마다 파일 하나, 프리앰블에 하나, 부록에 하나를 둡니다. LaTeX에는 이를 위한 명령이 두 가지 있으며, 둘 다 Scissor LaTeX에서 작동합니다.
| 명령 | 하는 일 | Scissor LaTeX에서 |
|---|---|---|
\input{file} | 직접 입력한 것처럼 파일의 텍스트를 바로 이 자리에 넣습니다. | 작동함. 프리앰블 안에서도, 중첩해서도 작동. |
\include{file} | 새 페이지를 시작하고, 파일의 텍스트를 넣고, 페이지를 끝냅니다. | 작동함. 연속된 페이지 나누기는 하나로 합쳐지므로 빈 페이지가 생기지 않음. |
\includeonly{a,b} | 목록에 없는 \include를 모두 빼고 조판합니다. | 무시됨: 모든 파일이 포함됨. |
\subfile{file} (subfiles) | \input과 같지만, 따로 컴파일할 수도 있는 파일용입니다. | 지원하지 않음: 메시지와 함께 건너뜀. \input을 쓰세요. |
\import{dir/}{file} (import) | 다른 폴더를 기준으로 한 \input입니다. | 지원하지 않음: 메시지와 함께 건너뜀. |
작은 프로젝트
일반적인 프로젝트에는 메인 파일과 장 폴더가 있습니다.
main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bib메인 파일에는 클래스, 프리앰블, 문서 본문이 있고, 나머지를 불러옵니다.
\documentclass{report}
\input{preamble}
\title{Rainfall at Two Sites}
\author{Erika Mustermann}
\begin{document}
\maketitle
\input{chapters/intro}
\input{chapters/method}
\bibliographystyle{plain}
\bibliography{refs}
\end{document}각 장 파일에는 프리앰블이나 \begin{document} 없이 자기 부분의 텍스트만 들어 있습니다.
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.Scissor LaTeX는 각 \input과 \include를 파일의 텍스트로 바꾸고, 결과를 하나의 문서로 조판합니다. 조판기에게는 모두 하나의 텍스트이므로 레이블, 참조, 인용이 파일을 넘나들며 작동합니다.
합쳐진 문서의 모습
main.tex가 \input으로 장 파일 두 개를 불러올 때 편집기가 조판하는 내용은 이렇습니다. 두 파일의 텍스트가 차례대로 이어집니다. (여기서 보여 주기 위해 예제는 파일 하나로 작성했습니다.) report나 book에서는 \chapter가 각 장을 자동으로 새 페이지에서 시작합니다.
하나의 문서로 합쳐진 두 장 파일
\documentclass{report}
\begin{document}
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.
\chapter{Method}
\label{chap:method}
Each gauge was emptied after reading, as noted in
Chapter~\ref{chap:intro}.
\end{document}
파일 이름을 찾는 방식
- 경로는 프로젝트의 최상위 폴더를 기준으로 합니다. LaTeX에서 메인 파일의 폴더를 기준으로 하는 것과 같으며, 중첩된 파일 안에서도 마찬가지입니다.
.tex확장자는 생략할 수 있습니다.\input{chapters/intro}는chapters/intro.tex를 찾습니다.\input{"my file"}처럼 이름을 감싼 따옴표는 제거됩니다.- 없는 파일은 문제 탭에
\input이 있는 줄과 함께 오류로 표시됩니다. 문서의 나머지는 그대로 조판됩니다. - 직접 또는 다른 파일을 거쳐 자기 자신을 포함하는 파일은 메시지와 함께 제외되며, 중첩은 24단계에서 멈춥니다.
subfiles와 \includeonly
subfiles 패키지를 쓰면 각 장을 따로 컴파일할 수 있습니다. Scissor LaTeX는 \subfile을 따라가지 않습니다. 명령은 건너뛰고, 문제 탭에 파일이 포함되지 않았다고 표시됩니다.
\subfile은 따라가지 않습니다
\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}문제 탭: 1 included file is not part of this conversion
한 번에 한 장씩 작업하려면 다른 \include 줄을 %로 주석 처리하세요. \includeonly는 받아들이지만 효과가 없으며, 포함된 모든 파일이 조판됩니다. \lstinputlisting과 \inputminted도 마찬가지로 같은 메시지와 함께 건너뜁니다(코드 목록 참고).
프로젝트의 다른 파일
이미지, .bib 파일, 데이터 파일은 어느 폴더에 두어도 됩니다. \includegraphics{figures/plot.png}처럼 최상위 폴더 기준 경로로 참조하세요. \bibliography에 어떤 이름을 쓰든 프로젝트의 모든 .bib 파일이 인용에 쓰입니다(참고문헌 참고). TeX 설치 환경의 프로젝트 전체를 가져오려면 프로젝트와 파일을 참고하세요.
TeX 설치 환경과 다른 점
관련 패키지의 설명서는 CTAN에 있습니다: subfiles, import.
질문과 답변
\input과 \include의 차이는 무엇인가요?
\input은 파일의 텍스트를 그 자리에 붙여 넣습니다. \include는 그 앞뒤로 새 페이지를 시작하고 끝내며, TeX 설치 환경에서는 \includeonly와 함께 작동합니다. Scissor LaTeX에서는 둘 다 장에 쓸 수 있고, \includeonly는 무시되므로 모든 \include가 조판됩니다.
\input 파일을 왜 찾지 못하나요?
프로젝트 최상위 폴더 기준 경로와 대소문자를 포함한 철자를 확인하세요. 문제 탭에 찾으려던 이름과 \input이 있는 줄이 표시됩니다.
Scissor LaTeX에서 subfiles가 작동하나요?
아니요. \subfile{...}을 \input{...}으로 바꾸세요. 그러면 장 파일에 자체 프리앰블이 필요 없습니다.
이 페이지의 모든 예제는 사이트를 빌드할 때 Scissor LaTeX로 조판됩니다. 마지막 업데이트: 2026-11-07