# Ваші файли й дані

Дізнайтеся, що подорожує разом із проєктом і як створювати резервні копії вихідного коду, історії та даних застосунку.

Ваш рукопис — це папка зі звичайними вихідними файлами. Ви можете відкрити ці файли в іншому редакторі, створити їхні резервні копії або забрати їх з Oleafly.

## Файли проєкту

Проєкти з бібліотеки зазвичай живуть у `~/.oleafly/projects/`. Проєкт може містити головний документ LaTeX, Typst або Markdown, бібліографію, рисунки та дослідні матеріали.

`project.json` записує ідентичність і налаштування проєкту, зокрема його головний документ, рушій і закріплену версію Typst. Каталог `.git` зберігає історію Git. Проєкт, створений або імпортований Oleafly, зазвичай починається з одного коміту своїх файлів під назвою «Створити проєкт» (див. [Git і контроль версій](/docs/git-history/#the-first-commit)). Каталог `.oleafly/build/` містить згенерований результат збірки, і його можна відтворити компіляцією.

Проєкт Typst може тримати копії пакетів, які він імпортує, у папці `typst-packages`, тож він компілюється офлайн і на інших комп’ютерах. Typst також використовує шрифти з папки `fonts` проєкту. Обидві папки подорожують разом із проєктом.

Папка, яку ви [відкриваєте на місці](/docs/library/#folders-opened-in-place), лишається там, де є. Oleafly зберігає збірки, налаштування, контрольні точки та чати цієї папки у власній теці даних, тож до вашої нічого не додається.

## Дані, збережені поза проєктом

Налаштування застосунку, зашифровані облікові дані провайдерів, записи чатів і використання, завантажені інструменти на кшталт додаткових версій Typst і збережені контрольні точки належать до локального сховища застосунку. Туди ж належать копії проєкту, які Oleafly зберігає перед кожним ходом асистента або агента: вони дають змогу скасувати зміни файлів, зроблені під час того ходу. Копія вашої бібліотеки Zotero, яку читає пошук `@`, теж живе там, а не в проєкті. Копіювання папки рукопису не копіює всіх цих даних застосунку.

[Зв’язані папки](/docs/linked-folders/) лишаються у своїх початкових місцях. Архів вихідного коду не включає їхній вміст лише через те, що ви їх зв’язали.

## Де живуть нотатки

[Нотатки](/docs/notes/) — це файли Markdown на вашому комп’ютері. Кожна особиста нотатка — це тека в теці проєктів, поруч із проєктами вашої бібліотеки. Нотатка проєкту — це файл `.md` у теці `notes` проєкту, тож вона подорожує разом із проєктом. Теку для Windows, macOS і Linux та вміст теки нотатки дивіться в [Де зберігаються нотатки](/docs/notes/#where-notes-are-stored).

## Де живе TinyTeX

Коли ви встановлюєте TinyTeX із **Налаштування → Рушії → LaTeX**, Oleafly кладе його в `~/.oleafly/tinytex`. Винятком є Windows, коли назва вашої теки користувача містить літери з діакритикою чи нелатинські літери, як-от корейське або китайське ім’я, бо TeX Live не може працювати з такої теки. Тоді TinyTeX потрапляє в теку з назвою `Oleafly-` плюс короткий код усередині ProgramData, що зазвичай є `C:\ProgramData`. Права адміністратора не потрібні. Якщо Oleafly не може налаштувати й цю теку, він про це каже. Ви можете й далі компілювати через Tectonic або самі встановити TeX Live в `C:\texlive`.

Рядок TinyTeX у розділі **Керування дистрибутивами TeX** показує теку; наведіть курсор на розмитий шлях, щоб його прочитати. Вилучайте TinyTeX із цього рядка, а не видаляйте теку вручну.

## Резервні копії вашої роботи

| Що ви хочете зберегти | Як це зберегти |
| --- | --- |
| Вихідний код рукопису та ресурси проєкту | Скопіюйте папку проєкту або експортуйте ZIP із вихідним кодом |
| Коміти Git | Створіть резервну копію репозиторія або надішліть зміни до налаштованого віддаленого сховища |
| Збережені контрольні точки | Експортуйте зашифрований архів історії з розділу Версіонування |
| Налаштування застосунку та локальні записи | Включіть каталог даних Oleafly у звичайну резервну копію комп’ютера |
| Зв’язані дані та посилання | Створюйте резервні копії їхніх початкових папок |
| Проєкти та налаштування бібліотеки, поза цим комп’ютером | Увімкніть [хмарну синхронізацію](/docs/cloud-sync/), щоб тримати копію у своєму Dropbox |

ZIP із вихідним кодом не містить кешів збірки та Git. Використовуйте [синхронізацію з GitHub](/docs/github-sync/) для віддаленого репозиторія та [архіви контрольних точок](/docs/checkpoints/) для історії контрольних точок.

## Перенесення на інший комп’ютер

Установіть Oleafly і скопіюйте або клонуйте проєкт рукопису. Під’єднайте зв’язані папки та провайдерів моделей на тій машині. Проєкт несе при собі вибір компілятора й метадані; додаткові інструменти чи пакети може знадобитися встановити. Проєкт Typst, закріплений за версією, якої на цьому комп’ютері немає, запропонує завантажити її перед компіляцією.

## Шляхи на екрані

Шляхи всередині вашої домашньої папки показуються як `~/…` у Налаштуваннях, історії версій, докладностях про рушії та агентів і в чаті. У Налаштуваннях шляхи файлів і папок до того ж лишаються розмитими, поки ви не наведете на них вказівник або не перейдете до них клавішею Tab, тож знімок екрана не показує, де живуть ваші файли.

## Мережевий доступ

Написання й локальна коректура відбуваються на вашій машині. Хмарний ШІ отримує контекст, переданий вибраному провайдеру. Інструменти, що читають зображення та скановані PDF, користуються локальною моделлю Ollama, якщо ви не виберете для них хмарну модель або Mathpix; тоді файл іде до цього сервісу. Цитати Zotero звертаються до застосунку Zotero на вашому комп’ютері або до zotero.org, коли ви під’єднуєте обліковий запис. Пошук цитат, імпорт Zotero, інструменти alphaXiv, синхронізація з GitHub, завантаження пакетів і версій Typst, інші завантаження та перевірки оновлень звертаються до відповідних сервісів. [Спільне редагування наживо](/docs/collaboration/) надсилає кожен спільний проєкт на сервер спільної роботи, на якому ним поділилися. [Хмарна синхронізація](/docs/cloud-sync/) надсилає ваші проєкти та налаштування бібліотеки у ваш власний Dropbox. Відкриття Налаштування → Довідка та про застосунок отримує публічні числа: кількість зірок і форків проєкту на GitHub і скільки учасників онлайн у спільноті Discord. Ці запити не несуть жодних відомостей про обліковий запис, проєкт чи використання, а режим офлайн пропускає запит до Discord. І Tectonic, і Typst підтримують компіляцію з кешем у режимі офлайн.

[Прочитати принципи продукту →](/docs/philosophy/)
