# Синхронізація джерела і PDF

Переходьте від курсора до відповідного місця в PDF або клацайте PDF із ⌘/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 спершу відкриває потрібний файл, коли текст прибув з іншого файла, як-от дочірній `\input` у LaTeX або підключений файл `.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.
- Проєкти зображень і діаграм пропускають її, бо односторінковий рисунок у ній не потребує.
