실제 프로젝트에 있는 파일들

.tex, .bib, .cls, .sty, 그리고 커밋하면 안 되는 자동 생성 파일.

실제 프로젝트에 있는 파일들

컴파일을 마친 실제 LaTeX 프로젝트의 폴더를 열어 보면, 직접 작성한 것보다 훨씬 많은 파일이 보입니다. 대부분의 초보자는 이를 낯설어하고, 엉뚱한 파일을 지울까 하는 걱정에 폴더가 계속 어수선한 채로 남습니다. 이를 정리해 주는 구분이 있습니다. 어떤 파일은 직접 편집하는 소스이고, 어떤 파일은 템플릿이나 패키지가 제공하는 스타일이며, 나머지는 컴파일러가 실행할 때마다 다시 만드는 임시 작업 공간입니다.

직접 작성하는 파일

.tex 파일에는 텍스트, 섹션, 그림, 수식 같은 문서 본체가 들어 있습니다. .bib 파일은 참고문헌 데이터베이스로, 인용할 수 있는 논문이나 책마다 항목이 하나씩 있습니다. 직접 관리해도 되고 Zotero 같은 참고문헌 관리 프로그램에서 내보내도 됩니다. 나머지는 모두 이 파일들로 다시 만들 수 있으므로, 백업하고 버전 관리에 넣을 가치가 있는 파일은 이쪽입니다.

템플릿이 주는 파일

.cls 파일은 문서 클래스를 정의하며, \documentclass{...}에 이름을 적는 바로 그것입니다. 저널과 학회는 모든 투고물이 똑같이 보이도록 자체 클래스를 배포하며, 직접 편집할 일은 거의 없습니다. .sty 파일은 패키지로, \usepackage로 불러오는 재사용 가능한 매크로와 설정입니다. 여러 문서에서 사용자 정의 명령을 공유하고 싶어질 때에야 직접 작성하게 됩니다. .bst 파일은 BibTeX 인용 스타일을 기술하며, 마찬가지로 대개 투고처가 제공하는 파일을 그대로 넣어 쓰기만 합니다.

컴파일러가 만드는 파일

.aux 파일은 컴파일 단계 사이에서 상호 참조와 인용 데이터를 저장합니다. 절대 편집하지 말고, 지워도 괜찮습니다. 다음 컴파일이 다시 만들기 때문입니다. .log 파일은 컴파일러가 한 모든 일을 기록하며, 문제가 생겼을 때만 열어 볼 만합니다. .pdf는 우리가 실제로 원했던 출력입니다.

확장자역할직접 편집?
.tex소스 문서와 장예
.bib참고문헌 데이터베이스예 (또는 Zotero에서 내보내기)
.cls문서 클래스드물게, 배포된 템플릿
.sty패키지 / 스타일 파일직접 매크로를 작성할 때
.bstBibTeX 스타일드물게
.aux상호 참조 데이터아니요: 자동 생성
.log컴파일러 로그디버깅할 때 읽기
.pdf출력보기 / 제출

규모가 커져도 버티는 프로젝트 구성

paper/
main.tex
chapters/
figures/
refs.bib

최상위의 main.tex 하나가 진입점 역할을 하고, 장은 각자의 폴더에 두고 \input이나 \include로 불러오며, 이미지는 figures/에, 참고문헌은 refs.bib 하나에 둡니다. 이 구성은 4페이지짜리 논문이든 학위논문이든 관리하기 쉽게 유지됩니다. 장 파일 나누기에서 각 조각이 어떻게 연결되는지 볼 수 있습니다.

Git을 쓴다면 *.aux, *.log, 그 밖의 자동 생성 파일을 .gitignore에 추가해서 기록에는 진짜 소스만 남기세요. Oleafly 프로젝트는 디스크 위의 평범한 폴더이므로 이 조언이 그대로 적용됩니다. 가장 흔한 실수는 그 반대입니다. 이상한 컴파일 오류를 쫓을 때는 .aux 파일을 지우는 것이 해법인 경우가 많은데, 망가진 실행이 남긴 오래된 .aux 파일이 이후의 모든 컴파일을 오염시킬 수 있기 때문입니다.

루프 열기(으)로 돌아가기