PDF & SyncTeX

개요

TeX64는 통합 PDF 미리보기와 SyncTeX 양방향 탐색 기능을 제공합니다. PDF 미리보기는 툴바 빌드가 성공한 뒤 새로 고쳐지며, SyncTeX는 소스와 PDF 사이의 탐색을 연결합니다.

SyncTeX를 통해 소스 코드의 커서 위치가 PDF의 어디에 해당하는지 즉시 확인할 수 있으며, 반대로 PDF를 클릭하여 소스로 바로 이동할 수도 있습니다. 작업 스타일에 맞춰 여러 뷰 모드 중에서 선택할 수 있습니다.

플랫폼 안내: TeX64는 현재 macOS(Apple Silicon 및 Intel)용으로 제공됩니다. Windows 및 Linux 버전은 계획되어 있으나 아직 제공되지 않으므로, 아래 단축키는 macOS 키를 기준으로 표기했습니다. 본문에 표시된 Windows/Linux 대응 키는 해당 버전이 출시되면 적용됩니다.

PDF 미리보기 모드

TeX64는 툴바에서 수동 빌드가 성공한 뒤 PDF를 새로 고칩니다. 프로젝트 크기와 모니터 구성에 가장 적합한 보기 모드를 선택하세요.

통합 뷰어 (같은 창)

툴바에서 수동 빌드가 성공한 뒤 PDF가 새로 고쳐집니다. 에디터와 PDF가 같은 창 안에 통합되어 표시됩니다. 이 모드는 단일 모니터 환경이나 컴팩트한 구성에 이상적입니다. PDF 미리보기를 에디터의 바로 아래나 옆에 배치할 수 있어 자주 전환하며 작업할 때 편리합니다.

분할 뷰 (수직/수평)

에디터와 PDF를 나란히(수직 분할) 또는 위아래(수평 분할)로 표시할 수 있습니다. macOS에서는 Cmd+\로 모드를 전환합니다(Windows/Linux는 해당 버전 출시 후 Ctrl+\).

와이드 모니터에서는 왼쪽에 에디터, 오른쪽에 PDF 미리보기를 배치하면 소스와 출력을 동시에 효율적으로 검토할 수 있습니다. 더 큰 글꼴 크기나 확대 수준에서는 수평 분할 모드가 더 좋은 가독성을 제공합니다.

분리 모드 (별도 창)

PDF 뷰어를 독립 창으로 분리하여 별도 공간에 표시합니다. 이 모드는 멀티모니터 환경에서 특히 강력합니다. 메인 모니터에 TeX64를 표시하면서 보조 모니터에 PDF를 전체 화면으로 표시하여 발표 품질의 검토와 더 넓은 시야로 작업할 수 있습니다.

빌드 실패 시 동작

빌드가 실패하면 TeX64는 마지막으로 성공적으로 생성된 PDF를 유지합니다. 손상되었거나 부분적으로 렌더링된 PDF 파일은 결코 표시되지 않습니다. 이를 통해 오류를 수정하는 동안에도 마지막으로 성공한 버전을 참고할 수 있습니다.

PDF 뷰어 컨트롤

TeX64의 PDF 뷰어는 표준 탐색 동작을 지원합니다.

확대/축소 컨트롤

  • 확대: Cmd+= (Mac) 또는 Ctrl+= (Windows/Linux)로 확대합니다.
  • 축소: Cmd+- (Mac) 또는 Ctrl+- (Windows/Linux)로 축소합니다.
  • 확대/축소 재설정: Cmd+0 (Mac) 또는 Ctrl+0 (Windows/Linux)로 확대/축소를 기본값으로 재설정합니다.
  • 마우스 휠, 트랙패드 또는 핀치 제스처로도 확대/축소가 가능합니다.

스크롤 탐색

  • PDF를 스크롤하여 임의의 콘텐츠를 볼 수 있습니다. 방향키, 스크롤 휠 또는 트랙패드로 탐색합니다.
  • 스페이스 또는 Page Down으로 다음 페이지, Shift+스페이스 또는 Page Up으로 이전 페이지로 이동합니다.

페이지 탐색

  • Home/End: 문서의 첫 페이지 또는 마지막 페이지로 이동합니다.
  • PDF 뷰어 상단의 페이지 표시기를 클릭하면 특정 페이지로 직접 이동할 수 있습니다.

PDF 새로 고침 동작

현재 버전의 TeX64는 입력 중 자동으로 컴파일하지 않습니다. 툴바의 빌드 버튼으로 수동 빌드를 실행하고, 성공 후 PDF가 새로 고쳐집니다.

빌드 성공 시

빌드가 정상적으로 완료되면 TeX64는 PDF를 자동으로 다시 로드하여 최신 내용을 표시합니다. 기본적으로 스크롤 위치는 문서의 맨 위로 돌아갑니다.

스크롤 위치 보존

TeX64는 PDF가 업데이트될 때 스크롤 위치를 가능한 한 보존하려고 시도합니다. 사소한 변경의 경우 동일한 섹션을 계속 볼 수 있습니다. 문서 구조를 변경하는 큰 변경의 경우 스크롤 위치가 재설정될 수 있습니다.

빌드 실패 시 보존

빌드가 실패하면 이전에 성공한 PDF가 계속 표시됩니다. 오류 메시지를 확인하고 수정한 후 다시 빌드할 수 있습니다.

Forward SyncTeX (소스 → PDF)

Forward SyncTeX는 Jump를 사용하거나 SyncTeX at Build Time이 켜진 상태에서 빌드가 성공했을 때 현재 소스 커서에 해당하는 PDF 위치를 표시합니다.

커서 위치 강조

Jump를 실행하면 TeX64가 PDF의 해당 영역을 강조하거나 시각적 표시기를 보여 줍니다. 텍스트, 단락, 섹션, 그림이 최신 빌드 출력의 어디에 나타나는지 확인할 수 있습니다.

명시적 Jump 업데이트

Jump를 클릭하면 현재 커서 위치에서 Forward SyncTeX가 실행됩니다. SyncTeX at Build Time이 켜져 있으면 빌드 성공 후에도 TeX64가 해당 위치로 이동합니다. 커서 이동만으로는 PDF가 다시 빌드되거나 새로 고쳐지지 않습니다.

시각적 표시기

사각형, 배경색 또는 아이콘 같은 시각적 마커가 현재 커서 위치에 해당하는 영역을 나타내기 위해 PDF에 표시됩니다. 이를 통해 복잡한 문서에서도 소스 코드의 어느 부분이 PDF의 어느 위치에 해당하는지가 명확해집니다.

Reverse SyncTeX (PDF → 소스)

Reverse SyncTeX를 사용하면 PDF를 클릭하여 소스 코드의 해당 라인으로 바로 이동할 수 있습니다. PDF를 읽다가 편집이 필요한 부분을 발견하면 즉시 소스로 이동해 수정할 수 있습니다.

Cmd+클릭으로 이동

  • Mac: Cmd 키를 누른 채 PDF의 텍스트나 요소를 클릭합니다.
  • Windows/Linux(예정): 해당 버전 출시 후 Ctrl 키를 누른 채 PDF의 텍스트나 요소를 클릭합니다.

즉시 탐색

클릭하면 TeX64가 에디터를 전면으로 가져와 해당 소스 라인으로 자동으로 커서를 이동합니다. 행 번호가 강조되고 커서가 줄의 시작 부분에 위치합니다. 여러 줄에 걸친 블록(단락이나 figure 환경 등)의 경우 블록의 시작 줄로 이동합니다.

다중 파일 프로젝트에서의 동작

Reverse SyncTeX는 다중 파일 프로젝트에서 특히 강력합니다. \input 또는 \include로 분리된 파일의 요소를 클릭하면 올바른 외부 파일이 자동으로 열리고 해당 줄로 이동합니다. 프로젝트 구조와 관계없이 정확한 탐색이 동작합니다.

정밀한 위치 지정

점프 정밀도는 TeX64가 SyncTeX 파일에서 읽는 정보의 세분성에 따라 달라집니다. 일반적으로 단락 수준의 정확도로 올바른 줄로 점프하지만, 일부 LaTeX 패키지는 페이지 수준 같은 더 거친 정밀도를 초래할 수 있습니다.

다중 파일 프로젝트 지원

SyncTeX는 \input과 \include 명령으로 분리된 다중 파일 LaTeX 프로젝트에서 완전히 동작합니다. 올바른 루트 파일 구성과 정확한 경로가 필수입니다.

\input과 \include 이해하기

  • \input: 페이지 나눔 없이 지정한 파일을 현재 위치에 직접 포함합니다.
  • \include: 지정한 파일을 새 페이지부터 시작하여 포함합니다. \excludeonly로 개별적으로 제외할 수 있습니다.

두 방법 모두 SyncTeX에서 완전히 지원되며, 파일 간의 대응 관계를 정확히 추적하여 양방향 탐색을 가능하게 합니다.

루트 파일의 중요성

TeX64는 프로젝트의 루트 파일(\begin{document}을 포함하는 메인 파일)을 자동으로 감지하려고 시도합니다. LaTeX 파일이 여러 개 있는 경우 어떤 파일을 루트로 처리할지 명시적으로 지정해야 할 수 있습니다.

루트 파일이 올바르게 설정되지 않으면 SyncTeX는 작동하지 않습니다. 메뉴(「Set Root File」)나 프로젝트 설정에서 지정하세요.

파일 간 이동

Forward와 Reverse SyncTeX 모두 여러 파일에 걸쳐 매끄럽게 동작합니다. 에디터에서 어떤 파일이 활성화되어 있든 커서 위치는 PDF의 해당 위치에 정확히 반영됩니다. 마찬가지로 PDF에서 이동할 때도 올바른 관련 파일이 자동으로 열립니다.

SyncTeX 요구 사항

SyncTeX가 제대로 작동하려면 여러 구성 요소가 필요합니다.

synctex 바이너리

  • synctex 명령줄 도구가 설치되어 있어야 합니다.
  • MacTeX가 설치되어 있는 경우 synctex는 자동으로 포함됩니다.
  • TeX Live 설치에도 synctex가 포함됩니다.
  • 설치 확인: 터미널에서 「which synctex」를 실행합니다. 경로가 표시되면 synctex가 설치된 것입니다.

.synctex.gz 파일 생성

  • latexmk는 컴파일 중에 .synctex.gz 파일을 자동으로 생성해야 합니다.
  • TeX64의 빌드 과정은 기본적으로 .synctex.gz 생성을 활성화합니다.
  • 빌드가 성공한 후 프로젝트 디렉터리에 .synctex.gz 파일이 존재하는지 확인하세요.

latexmk 구성

  • .latexmkrc 또는 latexmkrc 파일에서 SyncTeX 생성 옵션을 구성하세요.
  • 권장: $pdf_mode = 1; (pdflatex) 또는 $pdf_mode = 4; (lualatex/xelatex)

TeX64 환경 확인

TeX64의 설정 > 환경 메뉴에서 사용 가능한 TeX 환경을 확인할 수 있습니다. 녹색 체크 표시(✓)는 synctex가 올바르게 설치되었음을 나타냅니다.

PDF 텍스트 검색

PDF 뷰어 내에서 텍스트를 검색할 수 있습니다. Cmd+F (Mac) 또는 Ctrl+F (Windows/Linux)로 검색 상자를 엽니다.

검색 기능

  • 검색어를 입력하면 PDF의 모든 일치 항목이 자동으로 강조됩니다.
  • 결과 탐색: 위/아래 화살표 버튼이나 Enter 키로 다음/이전 일치 항목으로 이동합니다.
  • 일치 개수: 검색 상자에 찾은 일치 항목의 총 개수가 표시됩니다.

PDF 주석과 편집

TeX64의 PDF 뷰어는 읽기 전용 미리보기입니다. PDF에 직접 주석, 하이라이트 또는 손글씨를 추가하는 기능은 지원하지 않습니다.

PDF에 주석을 추가해야 하는 경우 Preview.app, Adobe Acrobat, PDFExpert 같은 별도의 PDF 편집기 애플리케이션을 사용하세요. TeX64의 PDF 뷰어는 검토, 참조, 탐색 목적의 빠른 미리보기에 최적화되어 있습니다.

수동 미리보기 워크플로

현재 버전의 TeX64에는 라이브 Auto-build가 없습니다. 툴바에서 수동으로 컴파일하면, 빌드 성공 후 PDF 미리보기가 새로 고쳐집니다.

수동 미리보기 워크플로

  1. TeX64에서 LaTeX 파일을 열고 에디터에서 코드를 편집합니다.
  2. 파일을 저장합니다(Cmd+S / Ctrl+S).
  3. 툴바의 빌드 버튼을 클릭하여 latexmk를 실행합니다.
  4. 빌드가 성공하면 PDF 미리보기가 최신 출력으로 다시 로드됩니다.
  5. 소스에서 PDF로 이동할 때는 Jump를 사용하고, PDF에서 소스로 이동할 때는 PDF에서 Cmd+클릭을 사용합니다.

Auto-build 정보

현재 TeX64 빌드 메뉴에는 Auto-build 설정이 없습니다. Cmd+B는 \textbf{} 입력용이며, 수동 빌드는 툴바의 빌드 버튼을 사용합니다.

문제 해결

SyncTeX와 PDF 미리보기에 관한 일반적인 문제와 해결 방법을 소개합니다.

SyncTeX가 작동하지 않음

  • 확인 1: synctex 설치: 터미널에서 「which synctex」를 실행하여 synctex가 설치되어 있는지 확인합니다. 출력이 없으면 TeX 환경을 다시 설치하세요.
  • 확인 2: TeX64 환경 확인: TeX64의 설정 > 환경에서 녹색 체크 표시가 있는지 확인합니다.
  • 확인 3: 루트 파일 설정: 다중 파일 프로젝트의 경우 루트 파일이 올바르게 설정되었는지 확인합니다.

.synctex.gz를 찾을 수 없음

  • 툴바의 빌드 버튼으로 프로젝트를 다시 빌드하세요.
  • 빌드가 성공한 후 프로젝트 디렉터리에 .synctex.gz가 존재하는지 확인합니다.
  • 파일이 생성되지 않으면 latexmk 구성을 확인하세요.

점프가 부정확함

  • 일부 LaTeX 패키지(tikz, pgfplot 등)는 소스 매핑을 방해할 수 있습니다.
  • 매크로를 많이 사용하면 소스에서 출력으로의 매핑이 복잡해져 점프 정확도가 떨어질 수 있습니다.
  • 이런 경우 Forward/Reverse SyncTeX 양쪽 상호작용을 모두 사용하여 대략적인 위치를 파악하세요.

다중 파일 프로젝트 문제

  • 루트 파일 미설정: TeX64 메뉴에서 「Set Root File」을 선택하고 \begin{document}이 포함된 메인 파일을 지정합니다.
  • 경로 지정 오류: \input과 \include에 지정된 경로가 정확한지 확인합니다. 상대 경로를 사용하는 경우 루트 파일을 기준으로 올바른지 검증합니다.
  • 외부 파일이 열리지 않으면 경로 구분자(Mac은 슬래시, Windows는 백슬래시)를 확인하세요.

PDF가 업데이트되지 않음

  • 빌드 출력 패널에서 빌드 오류가 있는지 확인하세요. 빌드가 실패한 경우 PDF는 업데이트되지 않습니다.
  • 소스를 저장한 뒤 툴바의 빌드 버튼으로 수동 빌드를 실행하세요.
  • 빌드가 성공했음에도 PDF가 업데이트되지 않으면 TeX64를 재시작해 보세요.

일반적인 해결 방법

  • 프로젝트 재빌드: 메뉴에서 「클린 빌드」 또는 「재빌드」를 실행합니다.
  • TeX64 재시작: 애플리케이션을 종료한 후 다시 실행합니다.
  • TeX 환경 확인: 설정 > 환경에서 TeX/LaTeX 설치 상태를 확인합니다.

성능 최적화

대용량 PDF 문서나 리소스 집약적인 LaTeX 파일의 경우 TeX64의 성능을 최적화할 수 있습니다.

대용량 PDF 처리

  • TeX64는 대용량 PDF를 효율적으로 렌더링하기 위해 페이지 단위 렌더링 전략을 채택합니다.
  • 보이는 영역만 렌더링: 화면 밖의 페이지는 메모리에 로드되지 않습니다.
  • 지연 로드: 페이지를 스크롤함에 따라 렌더링이 진행됩니다.

렌더링 최적화

  • GPU 가속: 지원되는 시스템에서는 GPU를 활용하여 렌더링 속도를 가속화합니다.
  • 캐싱: 이전에 렌더링된 페이지는 메모리에 캐시되어 탐색 시 다시 읽는 속도가 빨라집니다.
  • 적응형 품질 조정: 확대 수준과 메모리 사용량에 따라 렌더링 품질이 자동으로 조정됩니다.

컴파일 시간 단축

  • 증분 컴파일: latexmk를 사용하여 필요한 부분만 다시 컴파일합니다.
  • 드래프트 모드: \documentclass 옵션에서 draft 모드를 사용하여 이미지 처리를 단순화할 수 있습니다.
  • 불필요한 패키지 제거: 사용하지 않는 \usepackage 명령을 제거하면 컴파일 시간이 단축됩니다.

질문이 있거나 지원이 필요하면 지원 페이지를 방문하세요.