첫 한국어 LaTeX 문서 만들기와 컴파일
EasyLaTeX에서 프로젝트를 만들고 main.tex를 편집한 뒤 컴파일하면 첫 PDF를 만들 수 있습니다. 컴파일은 플랫폼에서 실행되므로 컴퓨터에 TeX를 설치할 필요가 없습니다.
프로젝트 만들기와 컴파일러 선택
- 빈 프로젝트를 만들고
main.tex를 열거나 새로 만듭니다. - 메인 파일로
main.tex를 선택합니다. 편집기에서 열어 둔 파일과 컴파일의 시작 파일은 다를 수 있습니다. - 편집기 설정에서 컴파일러를
xelatex(XeLaTeX)로 선택합니다. - 아래의 전체 예제를
main.tex에 붙여 넣고 저장이 끝난 뒤 컴파일합니다.
최소 문서
\documentclass[a4paper,12pt]{article}\usepackage{kotex}\begin{document}안녕하세요, LaTeX!\end{document}컴파일 후 PDF 미리보기에 “안녕하세요, LaTeX!”가 표시되어야 합니다. article은 기본 문서 구조를 제공하고 kotex는 한글 조판을 지원하며 XeLaTeX가 PDF를 생성합니다.
본문 수정과 결과 확인
본문은 \begin{document}와 \end{document} 사이에 작성합니다. 빈 줄을 넣으면 새 문단이 시작됩니다.
\begin{document}첫 번째 문단입니다. LaTeX는 문단 안의 줄바꿈과 줄 끝 공백을 자동으로 처리합니다.두 번째 문단입니다. 소스의 빈 줄로 새 문단을 시작합니다.\end{document}변경 사항이 저장된 뒤 다시 컴파일하고 현재 작업이 끝날 때까지 기다리세요. 소스 편집기와 PDF 미리보기는 별개입니다. 새 컴파일이 완료되어야 수정 내용이 PDF에 반영됩니다.
문서 구조 이해하기
| 부분 | 역할 |
|---|---|
\documentclass{article} | 기본 문서 형식 선택 |
| 서문 | \documentclass와 \begin{document} 사이. 패키지와 전역 설정 작성 |
\begin{document} | 본문 시작 |
\end{document} | 본문 끝 |
기존 템플릿을 사용한다면 지정된 메인 파일, 클래스, 필수 설정을 유지하세요. 템플릿 전체를 이 최소 예제로 교체하지 마세요.
컴파일 실패 시 확인할 사항
한글이 표시되지 않거나 문자가 빠지는 경우
프로젝트의 컴파일러가 XeLaTeX인지, 서문에 \usepackage{kotex}가 있는지 확인하고 수정하지 않은 최소 예제를 먼저 실행하세요. 다른 문자 체계를 사용할 때는 호환되는 템플릿, 컴파일러, 글꼴 설정이 필요합니다. 편집기의 화면 글꼴과 PDF 조판 글꼴은 다릅니다.
.cls, .sty 등의 파일을 찾지 못하는 경우
파일 트리에서 이름의 대소문자와 상대 경로를 확인하세요. 템플릿에 포함된 사용자 정의 클래스와 스타일 파일도 업로드해야 합니다. 수정하지 않은 최소 예제에서도 표준 클래스가 없다는 오류가 나면 프로젝트 식별 정보와 컴파일 로그를 보관해 지원팀에 문의하세요.
PDF가 갱신되지 않는 경우
선택한 메인 파일과 현재 컴파일 상태를 확인하세요. 컴파일을 누르면 현재 편집 내용을 먼저 저장합니다. 대기 중이거나 실행 중이면 완료를 기다리세요. 실패한 경우 이전에 성공한 PDF가 계속 표시될 수 있습니다. 도구 모음의 Bug 아이콘으로 오류 패널을 열고 오류와 원본 로그를 확인하세요. 파일명과 줄 번호가 있는 오류는 해당 위치로 이동하는 기능을 이용합니다. 첫 오류부터 수정한 뒤 다시 컴파일하세요.
전체 예제
\documentclass[a4paper,12pt]{article}\usepackage{kotex}\title{나의 첫 LaTeX 문서}\author{홍길동}\date{\today}\begin{document}\maketitle첫 번째 문단입니다. 이제 LaTeX로 한국어 문서를 작성할 수 있습니다.두 번째 문단입니다. 소스를 수정하고 다시 컴파일하면 PDF가 갱신됩니다.\end{document}