CorTeX 문서CorTeX 열기
CorTeX 열기
전체 문서 보기

LaTeX 프로젝트를 여러 파일로 나누기

주 문서 하나를 중심으로 긴 원고의 절, 그림, 참고문헌 데이터를 여러 파일에 체계적으로 나눕니다.

이 문서의 내용

긴 원고는 주 파일 하나가 문서 설정을 맡고 작은 파일들이 개별 절이나 리소스를 맡을 때 탐색하기 쉽습니다. 이 강의에서는 주 문서 하나로 논문 한 편을 구성합니다. 서로 다른 논문을 한곳에 두고 미리보기를 전환하려면 한 프로젝트에서 여러 논문 작성하기를 참고하세요.

프로젝트 트리 계획하기#

일반적인 연구 논문에는 다음 구조를 사용할 수 있습니다.

main.tex
sections/
  introduction.tex
  methods.tex
  results.tex
figures/
  calibration.pdf
references.bib
macros.tex

\documentclass, 패키지, 문서 전체 설정, document 환경은 main.tex에 둡니다. 재사용 정의는 macros.tex, 문헌 레코드는 references.bib, 논문의 일관된 각 부분은 절 파일 하나씩에 둡니다. 절 파일에서 문서 클래스를 반복하거나 새 문서를 시작하면 안 됩니다.

절 파일 포함하기#

CorTeX 파일 트리에서 폴더와 파일을 만들고 읽는 순서대로 main.tex에 포함하세요.

\documentclass{article}
\input{macros}
\begin{document}
\input{sections/introduction}
\input{sections/methods}
\input{sections/results}
\bibliographystyle{plain}
\bibliography{references}
\end{document}

\input은 페이지를 강제로 나누지 않고 해당 위치에 파일을 삽입합니다. .tex 확장자는 생략할 수 있습니다. \include는 장 단위의 큰 부분을 위해 설계되어 보통 새 페이지를 시작하며, 큰 책에서 일부 장만 컴파일할 때 \includeonly와 함께 사용할 수 있습니다.

다음 컴파일 예제는 문서 샘플을 독립적으로 유지하기 위해서만 filecontents*를 사용합니다. 실제 프로젝트에서는 introduction.tex를 별도 파일로 만드세요.

LaTeX 소스
\begin{filecontents*}{introduction.tex}
\section{Introduction}
This section is stored in its own file.
\end{filecontents*}
\documentclass{article}
\begin{document}
\input{introduction}
\section{Results}
The main file controls the document order.
\end{document}
컴파일 결과
CorTeX에서 열기

주 문서를 기준으로 경로 해석하기#

프로젝트 경로에는 /를 사용하며 대소문자를 구분합니다. 상대 LaTeX 경로는 명령이 있는 절 파일이 아니라 주 문서가 있는 폴더를 기준으로 해석됩니다. main.tex가 프로젝트 루트에 있다면 sections/results.tex 안에서 쓰는 그림도 figures/calibration.pdf로 작성합니다.

main.tex를 열어 이 논문의 미리보기를 선택하세요. 프로젝트를 열 때도 이 파일을 먼저 표시하려면 행 메뉴에서 주 문서로 설정을 선택합니다. 편집기에서 절 파일을 열어 두어도 CorTeX는 그 절이 속한 논문을 컴파일합니다. 덕분에 공동 저자는 공유 문서 순서나 프리앰블을 바꾸지 않고 각 파일에서 집중해 작업할 수 있습니다.

CorTeX에서 파일 이름을 바꾸거나 이동하면 인식된 LaTeX 참조를 갱신하고 프로젝트 변경 사항을 표시합니다. 사용자 매크로, 계산된 경로, 일반 문장에 적힌 경로 이름은 항상 안전하게 고칠 수 있는 것은 아니므로 검토하세요.

재현 가능한 프로젝트 유지하기#

설정이나 자료마다 관리할 위치를 하나로 정하세요. 절 파일마다 패키지를 중복해서 불러오거나 같은 정의를 서로 다르게 관리하는 매크로 파일 두 개를 두지 마세요. 선택한 TeX Live 스냅샷에 들어 있는 경우가 아니라면 논문에 필요한 .bib, 클래스, 스타일, 글꼴, 그림 파일을 프로젝트에 포함합니다. 크게 재구성하기 전에는 이름을 붙인 버전을 저장하세요.

파일을 추가하거나 옮긴 뒤에는 main.tex에서 컴파일하세요. 논문 전체가 의도한 순서로 나타나고, 상호 참조와 인용이 해결되며, 다른 공동 작업자가 개인 로컬 파일 없이 컴파일할 수 있으면 성공입니다. 의존성이 빠졌다면 파일을 찾을 수 없음 안내를 이용하세요.

관련 문서