# PDF 미리보기와 모든 컨트롤

컴파일된 문서를 읽고, 검색하고, 이동하고, 살펴보고, 저장합니다.

문서를 컴파일한 다음 **PDF 보기** 또는 **배치 → 미리보기만**을 선택해 읽기 점검을 합니다. 소스를 페이지 옆에 두고 싶다면 분할 보기를 사용하세요. 미리보기는 컴파일된 결과를 보여 줄 뿐, 원고 텍스트를 직접 편집하지는 않습니다.

![PDF 전용 보기의 LLaMA. 논문 위쪽에 확대/축소, 페이지 이동, 검색, 내보내기 컨트롤이 있습니다](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-preview-dark-window-v2.png)

## 로그

**로그**를 선택하면 컴파일 출력을 볼 수 있습니다. 이 컨트롤을 다시 선택하면 PDF로 돌아갑니다. 처음 나오는 조치 가능한 오류를 따라 해당 소스 파일로 이동해 수정한 뒤 다시 컴파일하세요. [로그 읽기](/docs/compiling/#reading-the-logs)를 참고하세요.

빈 로그에서 다시 시작하려면 **로그 복사** 옆의 **지우기**를 선택하세요. 다음 컴파일이 새 로그를 쓸 때까지 로그와 그 오류가 숨겨집니다. 빌드 파일은 그대로 남으며, 컴파일이 실행되는 동안에는 이 버튼을 쓸 수 없습니다.

컴파일을 실행할 수 없을 때 미리보기는 가능한 경우 해결 방법을 제안합니다. TeX 파일이 없는 `latexmk` 빌드에는 **찾아서 설치**가 표시됩니다. Tectonic이 할 수 없는 작업이 필요한 Tectonic 빌드에는 **엔진 선택**이 표시되며, 이 버튼은 [엔진 대화 상자](/docs/latex-engines/#when-tectonic-isnt-enough)를 엽니다. 이 컴퓨터에 없는 버전으로 고정된 Typst 프로젝트에는 해당 버전의 **Typst 다운로드**와 기본 버전의 **Typst 사용**이 표시됩니다. [고정한 버전이 없을 때](/docs/typst/#when-a-pinned-version-is-missing)를 참고하세요.

시스템 TeX(자동, pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX)로 컴파일하는 LaTeX 프로젝트가 작동하는 TeX 배포판이 없는 컴퓨터에 있으면 **TinyTeX 내려받아 사용**과 **Tectonic 사용**이 표시됩니다. 공유 프로젝트에서는 두 번째 버튼이 **모두에게 Tectonic 사용**으로 표시되는데, 모든 공동 작업자의 컴파일러가 바뀌기 때문입니다. TinyTeX는 내 컴퓨터만 바꿉니다. 공유 프로젝트의 설정을 바꿀 수 없다면 **TinyTeX 내려받아 사용**만 나타나며, 메시지가 내 컴퓨터에서 프로젝트를 컴파일하려면 TinyTeX를 설치하라고 안내합니다. 어떤 패키지에 XeLaTeX이나 LuaLaTeX이 필요한데 자동이 다른 컴파일러를 골랐다면 미리보기가 **XeLaTeX 사용** 또는 **LuaLaTeX 사용**을 제안합니다. upLaTeX나 pLaTeX가 없을 때는 Oleafly가 TeX 배포판에 추가할 수 있으면 **일본어 지원 설치(약 450 MB)**를 제안합니다.

## 빌드 소요 시간

로그 옆의 소요 시간은 완료된 컴파일에 걸린 시간을 알려 줍니다. 앱의 모든 부분을 측정한 값으로 보지 말고, 같은 프로젝트를 반복해서 빌드할 때 비교하는 용도로 사용하세요.

## 문서 개요

**문서 개요**를 선택하면 PDF의 탐색 트리가 열립니다. 항목을 펼치고 제목을 선택하면 해당 위치로 이동합니다. 개요는 PDF에서 가져오므로, 소스에 제목이 있어도 PDF 북마크가 없는 문서에는 항목이 없을 수 있습니다. **문서 개요 닫기**로 패널을 닫습니다.

## PDF 검색

![PDF 검색을 선택하면 오른쪽 위에 입력란이 열립니다. LLaMA에서 일치 항목이 강조 표시되고, 개수 옆에 이전/다음 결과 컨트롤이 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-search-dark-window-v2.png)

**PDF 검색**을 선택하고 **PDF 텍스트 검색**에 단어를 입력한 다음, 강조 표시된 결과를 확인하세요. **이전 검색 결과**와 **다음 검색 결과**로 일치 항목 사이를 이동합니다. **PDF 검색 닫기**를 선택하면 읽기 화면으로 돌아갑니다.

[LaTeX 연습 문서](/docs/writing/latex/)에서 `estimate`를 검색해 보세요. 검색은 PDF의 텍스트 레이어를 대상으로 하므로, 이미지로만 이루어진 스캔 페이지에서는 검색할 텍스트가 나오지 않습니다.

## 전체 화면 미리보기

**전체 화면 미리보기**를 선택하면 주변 편집기 패널 없이 읽을 수 있습니다. 돌아오려면 **전체 화면 종료**를 선택하거나 Esc를 누르세요. 발표 자료를 확인하거나 페이지를 크게 볼 때 유용합니다.

## 발표

프레젠테이션 아이콘인 **발표**를 선택하면 컴파일된 PDF를 슬라이드로 보여 줍니다. Beamer, Touying, Polylux 덱이 그 예입니다. **처음부터 발표**, **이 페이지부터 발표**, **발표자 보기로 발표** 중에서 고르세요. 발표자 보기는 다음 슬라이드, 타이머, 발표자 노트를 내 화면에 추가로 보여 줍니다. [슬라이드 발표](/docs/present-slides/)에서 키, 디스플레이가 하나일 때와 두 개일 때의 창 배치, 발표자 노트를 다룹니다.

## 브라우저에서 열기

Quarto 문서가 웹 페이지를 빌드하면 미리보기에 PDF 대신 그 페이지가 표시됩니다. 지구본 아이콘인 **브라우저에서 열기**를 선택하면 내 브라우저에서 열립니다. [Quarto](/docs/engines/#quarto)를 참고하세요.

## 도구 모음 숨기기

전체 화면에서 **도구 모음 숨기기**를 선택하면 페이지에 더 많은 공간을 줄 수 있습니다. 컨트롤을 다시 불러오려면 떠 있는 **도구 모음 표시** 컨트롤을 사용하세요.

## 축소

**축소**를 선택하면 미리보기 배율이 한 단계 줄어듭니다. 화면에서 페이지가 보이는 크기에만 영향을 주며, PDF의 용지 크기는 바뀌지 않습니다.

## 확대

**확대**를 선택하면 미리보기가 커집니다. 수식, 그래프 레이블, 작은 표 텍스트를 살펴볼 때 사용하세요. 지원하는 배율 범위는 40%에서 400%입니다.

## 확대/축소 비율

![미리보기 도구 모음: 개요, 검색, 전체 화면, 확대/축소 컨트롤, 페이지 번호, 페이지 배치, 읽기 컨트롤, 내보내기.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-pdf-preview-dark-window-v2.png#view=1230,44,689,49)

비율 메뉴를 열어 고정 확대/축소 프리셋을 선택하세요. 이 메뉴에는 너비에 맞추기, 높이에 맞추기, 100%로 되돌리기도 있습니다. 여러 수정본에서 같은 페이지를 비교할 때는 고정 값을 선택하세요.

## 너비에 맞추기

**너비에 맞추기**를 선택하면 페이지가 미리보기 영역의 너비에 맞춰집니다. 분할 배치에서 본문 텍스트를 읽을 때 사용하세요. 패널 크기를 크게 바꿨다면 다시 적용하세요.

## 높이에 맞추기

**높이에 맞추기**를 선택하면 페이지의 세로 범위 전체가 보입니다. 여백, 바닥글 위치, 페이지 균형을 확인할 때 사용하세요.

## 100%로 되돌리기

확대/축소 메뉴에서 **100%로 되돌리기**를 선택하면 기본 배율로 돌아갑니다. 뷰어의 배율만 되돌리며, 소스의 글꼴 크기는 바뀌지 않습니다.

## 트랙패드와 마우스 확대/축소

트랙패드에서 핀치하거나, Ctrl을 누른 채 스크롤 휠을 돌리면 확대/축소됩니다. 일반 스크롤은 문서를 따라 이동합니다. ⌘=, ⌘-, ⌘0(Windows와 Linux에서는 Ctrl)은 PDF에 포커스가 있을 때도 PDF를 포함한 [앱 전체를 확대/축소](/docs/settings/appearance/#zoom)합니다. PDF만 확대/축소하려면 도구 모음, 핀치, 또는 Ctrl과 스크롤 휠을 사용하세요.

확대한 페이지도 선명하게 유지됩니다. 보고 있는 부분은 전체 해상도로 다시 그려지고, 창을 픽셀 밀도가 다른 화면으로 옮기면 미리보기도 다시 그려집니다.

## 이전 페이지

**이전 페이지**를 선택하면 뒤로 이동합니다. 두 쪽 배치에서는 펼침면 단위로 이동합니다. 이미 처음에 있으면 이 버튼은 사용할 수 없습니다.

## 페이지 번호

페이지 번호 입력란을 클릭하고 페이지를 입력한 뒤 Enter를 누르세요. 스크롤하면 카운터도 현재 위치를 따라갑니다. 검토 메모에 적힌 페이지로 돌아갈 때 사용하세요.

## 다음 페이지

**다음 페이지**를 선택하면 앞으로 이동합니다. 문서 끝에서는 이 버튼을 사용할 수 없습니다.

## 한 쪽 보기

여러 페이지로 된 PDF에서 **한 쪽 보기**를 선택하면 페이지를 한 열로 읽을 수 있습니다. 문서를 계속 스크롤하며 읽으세요. 한 페이지짜리 문서에는 배치 전환이 필요하지 않아 숨겨집니다.

## 두 쪽 보기

**두 쪽 보기**를 선택하면 마주 보는 페이지가 표시됩니다. 학위논문, 책, 보고서의 균형을 펼침면 단위로 확인할 때 사용하세요. 좁은 읽기 열이 따라가기 쉬우면 한 쪽 보기로 돌아가세요.

## PDF 미리보기 색상 반전

**PDF 미리보기 색상 반전**을 선택하면 어두운 읽기 화면이 됩니다. 같은 컨트롤을 다시 선택하면 색상이 복원됩니다. 내보낸 PDF는 원래 색상을 유지하며, 이것은 화면 표시 설정입니다.

## 읽기 보기

**읽기 보기**를 선택하면 PDF 텍스트를 접근성 있는 읽기 형태로 볼 수 있습니다. 래스터화된 페이지에만 의존하지 않고 문서의 읽기 순서를 따라가려 할 때 사용하세요. 일반 페이지 화면으로 돌아가려면 읽기 보기를 종료하세요. 읽기 순서의 품질은 PDF가 제공하는 구조에 따라 달라집니다.

## 시계 방향으로 회전

**시계 방향으로 회전**을 선택하면 화면 표시가 90도 회전합니다. 반복해서 선택하면 원래 방향으로 돌아옵니다. 가로 방향 페이지나 회전된 다이어그램을 살펴볼 때 사용하세요. 뷰어의 회전은 문서 소스를 다시 쓰지 않습니다.

## PDF 다운로드

**PDF 다운로드**를 선택하면 현재 표시된 PDF를 저장합니다. 공유하기 전에 오래된 미리보기 알림이 있는지 확인하세요. 표시된 결과가 이전에 성공한 빌드일 수 있습니다. 이미지 프로젝트에는 대신 **이미지 다운로드**가 표시됩니다.

## PDF를 프로젝트에 저장

저장 아이콘인 **PDF를 프로젝트에 저장**을 선택하면 메뉴가 열립니다. 첫 항목의 이름이 같습니다. 이 항목은 파일 이름을 묻고 컴파일된 PDF의 사본을 프로젝트 트리에 다른 파일과 나란히 저장합니다. 이름은 **PDF 다운로드**와 마찬가지로 프로젝트 제목으로 시작합니다. 이미지 프로젝트에는 대신 **이미지를 프로젝트에 저장**이 있으며, 메뉴 없이 PNG로 저장합니다. 프로젝트 밖에 사본만 필요하다면 **PDF 다운로드**를 사용하세요.

도구 모음이 좁으면 두 항목 모두 **추가 미리보기 제어**에 들어 있습니다.

## 컴파일할 때 PDF 동기화

같은 메뉴에서 **PDF를 프로젝트에 저장** 아래에 있는 **컴파일할 때 PDF 동기화**를 켜면 프로젝트 폴더의 PDF가 최신 상태로 유지됩니다. 컴파일에 성공할 때마다 Oleafly가 메인 파일 이름과 상관없이 프로젝트 제목을 딴 이름의 PDF를 갱신합니다. 제목은 **PDF 다운로드**가 파일 이름을 짓는 것과 같은 방식으로 파일 이름이 되므로, `Thesis: Final Draft`는 `Thesis_Final_Draft.pdf`가 됩니다. 이 스위치는 프로젝트와 함께 저장됩니다.

- PDF는 일반 프로젝트 파일이므로 [클라우드 동기화](/docs/cloud-sync/)와 [체크포인트](/docs/checkpoints/)에도 함께 담깁니다.
- 프로젝트 이름을 바꾸면 다음 컴파일부터 새 제목으로 새 파일을 만듭니다. 이전 파일은 그대로 남습니다.
- Oleafly는 자신이 만들지 않은 파일을 덮어쓰지 않습니다. 그 이름의 파일이 이미 있으면 `Thesis_2.pdf`처럼 비어 있는 다음 이름을 씁니다.
- 빠른 컴파일은 PDF를 갱신하지 않습니다. **컴파일 모드**가 **빠르게**로 설정되어 있는 동안 메뉴에 그렇게 표시됩니다.
- 실시간으로 공유되는 [공동 작업](/docs/collaboration/) 프로젝트에서는 PDF가 공유되지 않습니다. 내 컴퓨터에만 남으며 메뉴에 그렇게 표시됩니다.
- 다른 앱이 파일을 잠그고 있어도 컴파일은 성공합니다. 메뉴에 메모가 표시되고, 다음 컴파일에서 다시 시도합니다.

## 미리보기를 새 창에서 열기

**미리보기를 새 창에서 열기**를 선택하면 뷰어가 운영 체제 창으로 분리됩니다. 메인 창에서 작성하는 동안 두 번째 디스플레이로 옮겨 두세요. 새 빌드와 프로젝트 변경 사항을 따라 갱신됩니다.

## PDF 미리보기 설정

![설정 → 모양 → PDF 미리보기. PDF 색상과 호버 미리보기의 기본값을 설정합니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-pdf-dark-window-v2.png#view=519,89,883,436)

**PDF 미리보기 설정**을 선택하면 **설정 → 모양 → PDF 미리보기**가 열립니다. 어두운 읽기 화면의 기본 동작과 라이브러리 호버 미리보기를 거기서 설정하세요.

## 추가 미리보기 제어

미리보기 패널이 좁으면 컨트롤이 **추가 미리보기 제어**로 옮겨집니다. 기능을 사용할 수 없다고 판단하기 전에 이 메뉴를 먼저 열어 보세요. 패널을 넓히면 더 많은 컨트롤이 도구 모음으로 돌아옵니다.

## 텍스트 선택과 복사

PDF에서 텍스트를 드래그해 선택한 다음 복사하세요. ⌘A(Ctrl+A)는 PDF 전체의 텍스트를 선택합니다. PDF 안의 링크는 계속 클릭할 수 있습니다. 선택 가능한 텍스트는 PDF의 텍스트 레이어에 달려 있습니다. 미리보기는 이미지뿐인 스캔본을 편집 가능한 텍스트로 바꿔 주지 않습니다.

## 소스로 이동

⌘ 또는 Ctrl을 누른 채 PDF의 단어를 클릭하면 해당하는 소스가 열립니다. 반대 방향은 소스 편집기의 **PDF로 이동**으로 이동합니다. 이 기능은 LaTeX 프로젝트와 Typst 0.13 이상의 Typst 프로젝트에서 작동합니다. 단축키와 제한 사항은 [소스와 PDF 동기화](/docs/synctex/)를 참고하세요.

## 오래된 미리보기

편집하거나 빌드에 실패한 뒤에도 뷰어는 마지막으로 읽을 수 있는 PDF를 유지할 수 있습니다. 오래된 미리보기 알림은 그 페이지가 현재 소스가 아니라는 뜻입니다. 최종 출력으로 사용하기 전에 컴파일을 성공시키세요.

다시 컴파일해도 PDF의 위치가 유지되며, 분리된 미리보기 창에서도 마찬가지입니다. 미리보기를 숨겼다가 다시 표시하면(예: ⌘⌥P(Ctrl+Alt+P)) 같은 위치에 바로 나타납니다.

**자동 컴파일**을 켜면 Typst 프로젝트는 입력을 멈춘 직후 미리보기를 갱신하고 스크롤 위치를 유지합니다. [자동 컴파일로 실시간 미리보기](/docs/typst/#live-preview-with-auto-compile)를 참고하세요.

## 처음부터 끝까지 읽기 점검해 보기

1. 연습 문서를 컴파일합니다.
2. 미리보기만과 높이에 맞추기를 선택합니다.
3. 문구를 검색해 결과로 이동합니다.
4. 개요를 열어 한 섹션으로 이동합니다.
5. 확대해서 수식이나 표를 확인합니다.
6. 분할 보기로 돌아가 소스를 수정합니다.
7. 다시 컴파일하고, 오래된 미리보기 알림이 사라졌는지 확인한 뒤, PDF를 다운로드합니다.
