# 소스와 PDF 동기화

커서에서 PDF의 해당 위치로 이동하거나, PDF를 Cmd/Ctrl-클릭해 소스의 그 단어로 이동합니다. LaTeX는 SyncTeX로, Typst에서는 파일을 넘나들며 작동합니다.

소스와 PDF 동기화는 내가 쓰는 글과 조판된 페이지를 연결합니다. LaTeX에서는 SyncTeX로 작동하며, Oleafly는 빌드할 때마다 SyncTeX 데이터를 켠 상태로 컴파일합니다. Typst에서는 Typst 언어 서버를 통해 작동하므로 추가 설정 없이 같은 이동이 가능합니다. 양방향 모두 동작 한 번이면 됩니다.

## 소스에서 PDF로: ⌘⇧J

![PDF로 이동은 편집기 도구 모음 맨 오른쪽, 찾기와 프로젝트 정보 옆에 있는 화살표입니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1799,76,119,49)

아무 줄에나 커서를 두고 ⌘⇧J(Ctrl+Shift+J)를 누르세요. PDF가 해당 위치로 스크롤되고 그 위에 파란 하이라이트가 잠깐 깜박여서, 커서가 있던 바로 그곳에 눈이 가게 됩니다.

편집기 도구 모음 맨 오른쪽의 화살표, 편집기의 오른쪽 클릭 메뉴, ⌘K 팔레트로도 실행할 수 있습니다. LaTeX 프로젝트에서는 이 명령의 이름이 **PDF로 이동(SyncTeX)**, Typst 프로젝트에서는 **PDF로 이동**입니다.

여러 파일로 이루어진 프로젝트에서도 작동합니다. `chapters/methods.tex` 안의 커서는 합쳐진 PDF에서 조판된 위치를 찾습니다. SyncTeX가 `\input` 구조를 따라가기 때문입니다. Typst도 메인 문서가 포함한 파일에 대해 똑같이 합니다.

![PDF의 단어를 클릭하면 소스의 같은 단어로 이동합니다.](https://cdn.oleafly.com/images/gifs/desktop/pdf-to-source.gif?v=2)

## PDF에서 소스로: ⌘-클릭

**⌘** 또는 Ctrl을 누르면 PDF 위의 포인터가 십자선으로 바뀝니다. 단어를 클릭하면 편집기에서 그 단어로 이동합니다. 텍스트가 LaTeX의 `\input` 하위 파일이나 포함된 `.typ` 파일처럼 다른 파일에서 왔다면 Oleafly가 먼저 알맞은 파일을 엽니다.

Oleafly는 커서를 줄의 시작이 아니라 클릭한 단어에 놓습니다. LaTeX에서는 PDF 텍스트 레이어를 읽어 그 단어를 찾고, Typst는 위치를 직접 알려 줍니다.

우선순위 규칙이 하나 있습니다. PDF의 하이퍼링크를 ⌘-클릭하면 이동하지 않고 링크 동작을 따릅니다.

## Typst 프로젝트

Typst 동기화에는 Typst 0.13 이상이 필요합니다. Typst 0.11 또는 0.12로 고정한 프로젝트는 정상적으로 컴파일되지만 PDF로 이동 버튼이 숨겨지고 ⌘-클릭은 아무 일도 하지 않습니다. 동기화를 되살리려면 컴파일 메뉴의 **Typst 버전(이 프로젝트)** 항목에서 더 새로운 버전으로 고정하세요. 문서의 레이아웃이 중요하다면 먼저 [새 버전 사용해 보기](/docs/typst/#try-a-newer-version-before-switching)를 해 보세요.

## 이동이 아무 일도 하지 않을 때

동기화 데이터는 마지막 컴파일에서 오므로 오래된 상태일 수 있습니다.

- **마지막 빌드 이후에 편집했습니다.** Oleafly는 바뀌지 않은 줄은 그대로 정확히 대응시키고 편집한 줄은 가장 가까운 바뀌지 않은 줄에 대응시키므로, 대부분의 이동은 계속 작동합니다. 이동한 위치가 틀리면 다시 컴파일(⌘↵)하고 다시 이동하세요.
- **그 줄에 눈에 보이는 출력이 없습니다**(주석, 프리앰블 줄, `#set` 규칙, 빈 줄). 조판된 텍스트가 있는 줄에 커서를 두세요.

## 적용되지 않는 경우

- [분리된 미리보기 창](/docs/pdf-preview/#open-preview-in-a-new-window)은 PDF를 그대로 보여 주지만 ⌘-클릭을 받지 않습니다. 메인 창에서 이동하세요.
- Markdown 프로젝트에는 소스와 PDF 동기화가 없습니다.
- 이미지와 다이어그램 프로젝트는 한 페이지짜리 그림에 필요하지 않으므로 건너뜁니다.
