# Синхронизация исходника и 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 превращается в перекрестие. Щёлкните слово, чтобы перейти к нему в редакторе. Oleafly сначала открывает нужный файл, если текст попал из другого файла, например из вложенного в LaTeX через `\input` или из подключённого файла `.typ`.

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 нет.
- Проекты изображений и диаграмм её пропускают, потому что одностраничному рисунку она не нужна.
