# Файли і папки

Провідник: створення, перейменування, переміщення та копіювання файлів, статус Git, головний документ, вкладки, перегляд зображень і PDF, і як автозбереження захищає вашу роботу.

Кожен проєкт — це справжня папка з файлами, і панель **Провідник** (перша вкладка на лівій панелі) — це інструмент роботи з нею. Проєкти з багатьма файлами підтримуються повноцінно: розбийте розділи на окремі файли `.tex`, тримайте зображення в папці, а компіляція, навігація і пошук Oleafly ідуть слідом.

![Дерево файлів LLaMA. Скористайтеся трьома кнопками біля заголовка панелі, щоб створити файл, створити папку або імпортувати наявні файли.](https://cdn.oleafly.com/images/screenshots/desktop/docs/project-files-dark-window-v2.png#view=0,45,344,638)

![Пошук у всіх файлах проєкту, а потім відкриття збігу на потрібному рядку.](https://cdn.oleafly.com/images/gifs/desktop/project-search.gif?v=2)

## Панель «Провідник»

Папки стоять першими, далі файли за алфавітом. Клацніть папку, щоб розгорнути або згорнути її, клацніть файл, щоб відкрити його у вкладці, і використовуйте клавіші зі стрілками разом із Enter для повної навігації з клавіатури. **Головний документ** проєкту (файл, з якого компілятор починає) позначено зіркою.

Дві кнопки в заголовку панелі щось створюють: **Новий файл** і **Нова папка**. Обидві створюють усередині вибраної папки або в корені проєкту, якщо нічого не вибрано. Введіть назву прямо в дереві й натисніть Enter; нові файли відкриваються одразу.

Службові речі приховані: внутрішні папки на кшталт `.git` і кеш збірки ніколи не з’являються в дереві, а символічні посилання не розгортаються.

## Статус Git у дереві

Коли проєкт використовує Git, Провідник позначає змінені файли тими самими літерами, що й [Контроль версій](/docs/git-history/):

| Літера | Значення |
|---|---|
| **M** | Змінено |
| **A** | Додано |
| **D** | Видалено |
| **R** | Перейменовано |
| **U** | Не відстежується (новий файл, який Git ще не відстежує) |
| **!** | Конфлікт |

Літера стоїть у правому кінці рядка, а наведення на неї показує назву статусу. Назви файлів зберігають свій звичайний колір. Папка зі змінами отримує крапку замість літери, забарвлену за найважливішою зміною всередині, тож конфлікт глибоко в `sections/` видно в рядку `sections`, навіть коли папку згорнуто.

## Контекстне меню

Для **файлу**:

- **Відкрити**
- **Зробити головним документом** (доступно для типів файлів, які компілює рушій проєкту, як-от `.tex`, `.typ` або `.md`): робить цей файл точкою входу компіляції та переносить зірку.
- **Перейменувати**: відредагуйте назву прямо в дереві. Відкриті вкладки, незбережені правки та вказівник головного документа йдуть слідом за перейменуванням, як і [шляхи, що вказують на файл](#paths-follow-a-moved-file).
- **Створити копію**: створює `name copy.tex` поруч з оригіналом. Працює побайтно, тож зображення та інші двійкові файли копіюються безпечно.
- **Видалити**: вилучає файл після підтвердження. Скасувати це із застосунку не можна, хоча [історія Git](/docs/git-history/) здатна повернути все, що ви комітили. У папці, відкритій на її місці, Видалення натомість переміщує файл до Смітника (Кошика у Windows).

Для **папки**: **Новий файл**, **Нова папка**, **Імпортувати файли**, **Імпортувати папку**, **Перейменувати**, **Створити копію** (копіює всю папку рекурсивно) і **Видалити**.

## Переміщення: перетягування

Перетягніть будь-який файл або папку на іншу папку, щоб перемістити їх усередину, або на порожню ділянку внизу дерева, щоб перемістити в корінь проєкту. Цілі перетягування підсвічуються під час наведення. Oleafly відмовляється виконувати переміщення, які помістили б папку всередину самої себе.

Файли й папки, перетягнуті з вашого файлового менеджера, копіюються в папку під вказівником. Це працює на macOS, Windows і Linux.

## Шляхи йдуть слідом за переміщеним файлом

Перейменування або переміщення файлу може зламати шляхи, що вказують на нього. Oleafly знаходить їх і оновлює:

- У LaTeX: команди `\input`, `\include`, `\includegraphics`, `\bibliography` та подібні.
- У Typst: `#include`, `image()` і `bibliography()`.
- У Markdown: посилання і зображення.

Запустити це можна з редактора або з Провідника. У редакторі поставте курсор на шлях і натисніть F2 або виберіть **Перейменувати файл…** у контекстному меню. Діалог **Перейменувати файл** приймає повний шлях, тож може ще й перемістити файл до іншої папки, і створює папки, яких ще немає. У Провіднику скористайтеся **Перейменувати** або перетягніть файл у нову папку.

Типово Oleafly питає першим. Діалог перелічує кожен файл, що досі використовує старий шлях, і скільки в ньому посилань. Виберіть **Оновити посилання** або **Не оновлювати** та позначте **Більше не питати**, щоб зберегти цю відповідь. Щоб змінити її пізніше, установіть **Коли файл переміщено** в **Налаштування → Зовнішній вигляд → Редактор** у значення **Питати**, **Завжди оновлювати** або **Ніколи не оновлювати**. Файл, який змінився після переміщення або не вдалося зберегти, лишається зі старим шляхом, і діалог про це каже.

## Вкладки

Відкриті файли з’являються як вкладки над редактором у порядку відкриття. Крапка на вкладці означає незбережені зміни (за мить вони автозберігаються). [Подання порівняння](/docs/git-history/) Git відкриваються як вкладки в тій самій смузі, позначені назвою файлу з доданим `(Index)` або `(Working Tree)`.

Закриття активної вкладки активує попередню. Історія скасувань ніколи не переходить між файлами: кожен файл тримає власну.

## Як відкриваються різні типи файлів

- **Файли LaTeX і текстові файли** (`.tex`, `.sty`, `.cls`, `.bib`, `.md` та подібні) відкриваються в редакторі з підсвічуванням синтаксису, підібраним під розширення.
- **Зображення** (`.png`, `.jpg`, `.gif`, `.webp`, `.svg` тощо) відкриваються як відтворене подання.
- **PDF** відкриваються в переглядачі PDF.
- **Нетекстові двійкові файли** (`.zip`, `.eps`, файли шрифтів) показують повідомлення «Двійковий файл. Перегляд недоступний.», а не ризикують пошкодити їх, завантажуючи як текст.
- **Файли `.bib`** також розбираються у фоні щойно проєкт відкривається, і саме це живить [автодоповнення цитувань](/docs/citations/#complete-and-navigate-references).

## Автозбереження

Вам ніколи не треба натискати «Зберегти». Правки записуються на диск приблизно через 1,5 секунди після того, як ви припиняєте друкувати, і Oleafly робить більше, ніж простий таймер:

- Відредагуйте файл A і перейдіть до файлу B до спрацювання таймера — A усе одно збережеться.
- Закриття або перезавантаження застосунку спершу записує всі збереження в черзі, тож вихід усередині вікна затримки нічого не втрачає.
- Компіляція спершу зберігає активний файл, тож PDF завжди відображає те, що ви бачите.

## Додавання наявних файлів

Скористайтеся **Імпортувати файли** або **Імпортувати папку** (у меню заголовка панелі та в контекстному меню), щоб скопіювати зображення, файли `.bib` або цілі каталоги з будь-якого місця на диску в проєкт. Імпорт у вибрану папку кладе копії туди; інакше вони потрапляють у корінь проєкту.

Оскільки проєкт водночас є звичайною папкою, прямий шлях теж працює: скиньте файли в `~/.oleafly/projects/<project>/` своїм файловим менеджером, потім знову відкрийте проєкт, щоб Oleafly їх підхопив. Копіюйте, поки проєкт закрито (або одразу знову відкрийте), бо автозбереження застосунку записує те, що тримає в пам’яті.
