도움말 센터

LaTeX와 Typst 프로젝트를 작성하고 컴파일하며 공유하기 위한 실용적인 안내입니다.

PDF 컴파일과 미리보기

LaTeX 또는 Typst 문서를 빌드하고 로그를 읽고 컴파일 방식을 고릅니다.

이 가이드의 대상

빌드하고 결과 읽기

편집기에서 컴파일하고 생성된 PDF를 확인하세요. 오류가 있으면 로그도 바로 볼 수 있습니다.

방법

  1. 키보드, 상태 표시줄, 또는 PDF 창의 빌드 버튼으로 컴파일합니다.
  2. 오류와 경고는 문제 탭에 묶여 표시됩니다. 심각도로 걸러 내고 소스로 이동으로 해당 줄에 갑니다.
  3. 묶음 보기로 부족할 때는 출력 탭에서 원본 로그(LaTeX는 latexmk의 로그, Typst는 Typst 자체의 메시지)를 확인하세요.
  4. 문제 목록에서 바로 어시스턴트에게 특정 문제(또는 전부)의 설명이나 수정을 요청할 수 있습니다.
  5. 컴파일이 진행되는 동안 상태 표시줄이나 PDF 창의 빌드 버튼에 있는 ‘컴파일 중…’을 클릭하면 중지됩니다.
  6. 빌드가 낡은 보조 파일을 재사용하는 것 같으면 ‘컴파일’ 버튼 옆의 컴파일 메뉴를 열어 ‘캐시를 지우고 다시 컴파일’을 고르세요.

또는 로 프로젝트를 컴파일합니다. 로 진행 중인 컴파일을 중지합니다. 키와 키로 다음 문제와 이전 문제로 이동합니다.

투고 전에 PDF 검사하기

‘프로젝트 검사’에는 네 탭이 있습니다. ‘소스 검사’는 컴파일하지 않고 소스를 읽고, ‘참고 문헌’은 참고 문헌을 검증하며, ‘PDF’는 컴파일된 PDF 자체와 마지막 컴파일의 경고를 읽어 출판사의 검사 도구나 독자가 알아챌 문제를 보여 주고, ‘마지막 컴파일’은 컴파일 자체의 오류와 경고를 나열합니다.

방법

  1. ‘소스 검사’ 탭에서 ‘검사 실행’을 누르면 루트 문서와 그 의존 파일을 훑어, 중복된 레이블과 참고 문헌 키, 정의되지 않은 인용과 참조, 없을 수 있는 파일·이미지·참고 문헌, XeLaTeX나 LuaLaTeX가 필요한 패키지를 나열합니다.
  2. 컴파일한 뒤 ‘프로젝트 검사’를 열고 PDF 탭을 선택합니다.
  3. 포함되지 않은 글꼴과 Type 3(비트맵) 글꼴이 보고됩니다. 대개 다른 프로그램에서 내보낸 그림에서 비롯됩니다.
  4. 정의되지 않은 참조와 인용, 글꼴에 없는 문자, 여백을 넘는 줄, 크기가 다른 페이지는 처음 살펴볼 위치와 함께 각각 한 번씩 보고됩니다.
  5. 페이지보다 긴 그림이나 표, 아직 한 번 더 실행을 요구하는 컴파일, 실패한 컴파일 뒤에 남아 있는 이전 컴파일의 PDF도 보고됩니다.
  6. ‘소스 검사’ 탭에서 익명 투고 검사를 켜면 PDF 메타데이터에 저자가 있을 때에도 경고합니다.

엔진과 루트 파일 고르기

루트 파일과 LaTeX 엔진을 지정해 팀 전체가 같은 설정으로 컴파일할 수 있습니다.

방법

  1. 프로젝트 설정에서 루트 .tex 파일, 즉 \documentclass가 들어 있고 컴파일러에 전달되는 파일을 지정하세요.
  2. 엔진을 고릅니다. pdflatex, latex, xelatex, lualatex 중에서 고르며, fontspec으로 글꼴을 불러오면 XeLaTeX나 LuaLaTeX가 필요합니다.
  3. TeX Live 버전을 선택하세요. 예전 빌드를 재현하려면 이전 버전을 유지하는 것이 가장 안전합니다.
  4. 컴파일 모드를 정합니다. 실제 문서는 일반, 구조만 빠르게 확인할 때는 빠른 초안입니다.

컴파일 시점 선택하기

필요할 때 직접 컴파일하거나 입력을 멈춘 뒤 자동으로 컴파일하도록 설정하세요.

방법

  1. 자동 컴파일을 켜면 입력이 멈춘 뒤 다시 빌드되고, 꺼 두면 원할 때만 빌드합니다.
  2. 로그가 길어 진짜 원인을 찾기 어려우면 첫 오류에서 중지를 켜세요.
  3. 커서에서 PDF의 해당 위치로 이동할 수 있고, PDF의 아무 곳이나 더블 클릭하거나 Cmd/Ctrl을 누른 채 클릭하면 그 소스 줄로 되돌아옵니다.
  4. 프로젝트 메뉴에서 PDF를 내려받거나, 인쇄를 위해 별도 브라우저 탭에서 열 수 있습니다.

로 소스에서 PDF로 이동합니다. PDF에 포커스가 있을 때는 화살표 키, Page Up, Page Down, Home, End, 스페이스바로 스크롤하고, +와 -로 확대·축소하며, 0으로 너비에 맞춥니다. 를 누르면 선택한 텍스트나 화면 가운데에서 소스로 돌아갑니다. 는 ‘PDF에서 찾기’를 엽니다.

질문, 버그, 아이디어JointTex 포럼에서 커뮤니티에 질문하고, 버그를 신고하고, 기능 요청에 투표하세요.
계정, 결제 또는 개인정보 문의계정, 구독 또는 개인 데이터에 관한 사항은 지원팀에 이메일로 문의하세요.
[email protected]
JointTex

Browser compatibility

JointTex could not start

The application did not finish loading. Check your connection, then try again.

Supported versions

  • Chrome and Edge 88 or later
  • Firefox 84 or later
  • Safari and iOS Safari 14 or later
Reload