# Часті питання та усунення несправностей

Швидкі відповіді про початок роботи, проєкти, компіляцію, асистентів і резервні копії.

## Початок роботи

### Чи потрібен обліковий запис?

Ні. Завантажте Oleafly, відкрийте його й пишіть. Необов’язкові служби, як-от хмарний постачальник ШІ, GitHub чи Dropbox, використовують власні облікові записи.

### Чи підтримує Oleafly LaTeX, Typst і Markdown?

Так. Виберіть рушій під час створення проєкту. Кожен рушій має власні можливості редагування та експорту. [Швидкий старт](/docs/getting-started/) проведе вас через створення першого PDF.

### Чи можна перенести наявну статтю або резюме?

Так. Імпортуйте вихідний код проєкту, ZIP-архів або репозиторій Git. У Oleafly є також шляхи перетворення для DOCX і текстових PDF. Прочитайте [Занесення наявної роботи](/docs/import-project/), щоб вибрати відповідний маршрут.

### Чи можна працювати офлайн?

Писати, упорядковувати файли, використовувати локальну вичитку і завантажену локальну модель ШІ можна без з’єднання з хмарою. Tectonic може компілювати з кешованих пакунків. Нові пакунки, віддалені посилання, хмарні моделі, GitHub і завантаження потребують з’єднання. Підготуйте проєкт із успішною компіляцією, перш ніж працювати з ним офлайн.

### Де мої файли?

Ваші проєкти — звичайні теки у вашій локальній бібліотеці. Їх можна копіювати, створювати для них резервні копії або відкривати їх в іншому інструменті. У статті [Ваші файли та дані](/docs/where-your-data-lives/) пояснено файли проєкту, налаштування застосунку й контрольні точки.

### Чи підійде Oleafly для дисертації або резюме?

Так. Почніть із [робочого процесу дисертації](/docs/workflows/thesis/) або [робочого процесу резюме](/docs/workflows/resume/). Обидва використовують той самий редактор, перегляд, посилання та інструменти експорту, що й наукова стаття.

## Встановлення

### Операційна система блокує інсталятор

Перевірте, що файл походить із [офіційних випусків](https://github.com/Oleafly/Oleafly/releases/latest) і відповідає вашій платформі. Зверніться до [інструкції зі встановлення](/docs/install/#first-launch) за першими кроками запуску для цієї платформи.

### Який пакунок для Linux мені обрати?

Виберіть архітектуру, що відповідає вашому комп’ютеру, і пакунок AppImage, Debian або RPM. Системні вимоги див. у статті [Встановлення в Linux](/docs/install/#linux).

## Компіляція

### Моя перша компіляція повільна

Tectonic може завантажувати пакунки, які використовує цей документ, а перша компіляція на комп’ютері також одним махом завантажує набір поширених. Вони кешуються для наступних збірок. Поки пакунки ще завантажуються, компіляція може перевищити звичайний п’ятихвилинний ліміт. Відкрийте [Журнали](/docs/compiling/#reading-the-logs), щоб побачити, що відбувається.

### Бракує пакунка

Якщо увімкнено Режим офлайн, виберіть **Вимкнути й скомпілювати** у повідомленні або вимкніть його на одну компіляцію, щоб отримати пакунок. У системному інструментарії TeX скористайтеся **Знайти і встановити** в повідомленні про помилку. TeX Live з Debian, Ubuntu чи Fedora отримує пакунки через `apt` або `dnf`. Див. [Рушії LaTeX і пакети](/docs/latex-engines/#recover-from-a-missing-file).

### Після вибору pdfLaTeX Oleafly просить дистрибутив TeX

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX і pLaTeX працюють на дистрибутиві TeX, встановленому на вашому комп’ютері. Коли його немає, вибір будь-якого з них відкриває діалог ще до компіляції. Виберіть **Завантажити і використати TinyTeX**, щоб його встановити, або **Повернутися до Tectonic**, щоб повернутися до вбудованого рушія. Після невдалої компіляції перегляд пропонує той самий вибір як **Завантажити і використати TinyTeX** та **Використати Tectonic**. Див. [Коли TeX не встановлено](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX пише, що latexmk потрібен Perl

`latexmk` у MiKTeX працює на Perl, якого MiKTeX не містить. Встановіть Strawberry Perl або встановіть TinyTeX із **Налаштування → Рушії → LaTeX**, який приносить власний Perl і перебирає компіляції від MiKTeX. Див. [MiKTeX і Perl](/docs/latex-engines/#miktex-and-perl).

### У моєму PDF бракує тексту

Шрифт не має гліфів для цих символів. Найчастіше це трапляється з корейським, китайським і японським текстом, і TeX пропускає символи, не зриваючи компіляції. Oleafly попереджає вас і перелічує їх у журналі. У LaTeX вставте налаштування, яке попередження дає для вашого письма. У Typst завантажте пакет шрифтів, який пропонує сповіщення, або додайте шрифт із цими символами до теки `fonts` проєкту. У Markdown задайте `mainfont` або `CJKmainfont` у заголовку YAML шрифтом, що їх має. Див. [Символи, яких бракує в PDF](/docs/latex-engines/#characters-missing-from-the-pdf) і [Символи, що показуються як квадрати](/docs/typst/#characters-that-show-as-boxes).

### Oleafly зупинив мою компіляцію через надто довгий час

Компіляція може тривати 5 хвилин. Поки пакунки ще завантажуються, ліміт розтягується до 30 хвилин. Markdown у PDF отримує 15 хвилин, а Quarto і Calepin — годину. Скомпілюйте знову: завантаження продовжується з місця зупинки. Для довгих чернеток у Tectonic установіть **Режим компіляції** на **Швидкий** у меню компіляції.

### Чи можуть нові проєкти використовувати мою власну установку TeX?

Так. Відкрийте **Налаштування → Рушії → LaTeX** і поставте **Типовий рушій компіляції** на **latexmk (системний TeX)**. Нові, імпортовані та перетворені проєкти LaTeX починатимуть із нього. Див. [Типовий рушій для нових проєктів](/docs/engines/#set-a-default-for-new-projects).

### Мій документ використовує minted або PythonTeX

Ці пакунки запускають інші програми під час компіляції документа, що Oleafly типово блокує. Вони потребують системного LaTeX. Якщо ви довіряєте кожному файлу в проєкті, виберіть **Дозволити зовнішні команди** на смузі над редактором. Див. [Дозвіл зовнішніх команд](/docs/latex-engines/#allow-external-commands).

### Компіляція завершилася з попередженнями

Відкрийте **Журнали** та спершу перевірте невизначені цитування й посилання. [Передперевірка](/docs/preflight/) допомагає знайти відповідні місця в коді перед експортом.

### Я не розумію помилку компіляції

Попросіть асистента прочитати журнал, виправити помилку та скомпілювати знову. Скористайтеся режимом **Питати дозволу**, коли хочете переглядати запропоновані дії на шляху. Також можна опублікувати журнал на форумі допомоги в [Discord](/discord).

### Чому бракує формату експорту?

Доступні формати залежать від рушія й типу документа. Зверніться до [таблиці експорту](/docs/export/#editable-formats).

## Асистенти ШІ

### Якого асистента можна використати?

Підключіть постачальника моделей, використайте локальну модель або виберіть [CLI-агента](/docs/cli-agents/). У статті [Налаштування ШІ](/docs/ai-setup/) описано кожен шлях.

### Чи потрібен ШІ для роботи з редактором?

Ні. Написання, компіляція, цитування, перегляди, діаграми, історія проєкту й експорти доступні без асистента.

### Що може асистент?

Він може працювати з файлами проєкту, шукати джерела, досліджувати PDF, створювати рисунки, запускати інструменти й допомагати полагодити збірку. Виберіть план і політику погодження, що пасують цій роботі. Див. [Робота з асистентом](/docs/ai-chat/).

### Що означає позначка «Перевірена» біля моделі?

Модель пройшла перевірку викликами інструментів. Це допомагає вам обрати модель для дій над проєктом; це не оцінює якість її письма чи досліджень. Див. [Налаштування ШІ](/docs/ai-setup/).

### Чому використання показано як «Невідомо»?

Деякі постачальники та CLI-агенти не передають дані про використання. «Невідомо» означає, що значення недоступне. Прочитайте [Використання та бюджети](/docs/ai-usage/).

### Чи можна підключити зовнішнього асистента?

Так. Використайте вбудоване [підключення CLI-агента](/docs/cli-agents/), увімкніть локальний [сервер MCP](/docs/mcp/) Oleafly або підключіть свого агента до [команди `oleafly`](/docs/cli/), яка працює і тоді, коли застосунок закрито.

## Історія та співпраця

### Як відновити попередню версію?

Відкрийте [Контрольні точки](/docs/checkpoints/), щоб порівняти код успішних збірок і відновити версію. Для комітів Git, якими ви керуєте самі, використовуйте [Контроль версій](/docs/git-history/).

### Чи можна працювати зі співавтором?

Так. Зі [спільною роботою в реальному часі](/docs/collaboration/) ви й ваші співавтори редагуєте той самий проєкт одночасно через сервер співпраці, який запускає ваша група. Кожен із вас зберігає проєкт як файли на власному комп’ютері. Можна також обмінюватися архівами коду або використати [синхронізацію GitHub](/docs/github-sync/) для обміну комітами.

### Чи можна користуватися своїми проєктами на двох комп’ютерах?

Так. [Хмарна синхронізація](/docs/cloud-sync/) зберігає проєкти вашої бібліотеки та ваші налаштування у вашому власному Dropbox, і кожен підключений комп’ютер може їх завантажити. Щоб підключити її, відкрийте **Налаштування → Сховище даних → Хмарна синхронізація**. Проєкт можна також перенести між комп’ютерами через [синхронізацію GitHub](/docs/github-sync/).

### Чи експорт коду створює резервну копію всього?

Він резервно копіює вихідний код проєкту. Автоматичні контрольні точки, налаштування застосунку та облікові дані зберігаються окремо. Зверніться до [інструкції щодо резервних копій](/docs/where-your-data-lives/#back-up-your-work), щоб охопити потрібне.

## Повідомити про проблему

Відкрийте **Налаштування → Довідка та про застосунок → Копіювати відомості** і додайте ці відомості до короткого опису, кроків відтворення проблеми та відповідного журналу. Повідомте про неї в [Issues](https://github.com/Oleafly/Oleafly/issues); для питань і допомоги з робочим процесом використовуйте [спільноту Discord](/discord).
