# Завантаження та встановлення

Встановіть Oleafly на macOS, Windows або Linux, а потім дізнайтеся, що застосунок може завантажити при першому використанні.

Встановлення Oleafly — це завантаження та подвійне клацання. Без облікового запису, без входу й без окремого дистрибутива LaTeX: компілятор постачається всередині застосунку.

## Завантаження застосунку

Візьміть останній інсталятор зі [сторінки релізів](https://github.com/Oleafly/Oleafly/releases/latest) або скористайтеся кнопкою завантаження на [oleafly.com](https://oleafly.com/), яка, коли може, підбирає інсталятор для вашої платформи.

| Платформа | Завантаження | Що робити |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 або новіший. Відкрийте dmg і перетягніть Oleafly до Програм. |
| macOS (Intel) | `_x64.dmg` | Mac на Intel. Відкрийте dmg і перетягніть Oleafly до Програм. |
| Windows (x86_64) | `.msi` або `-setup.exe` | Запустіть будь-який інсталятор і дотримуйтеся вказівок. |
| Linux (x86_64) | `.AppImage`, `.deb` або `.rpm` | Використовуйте AppImage на більшості дистрибутивів, пакунок Debian на системах на основі Debian або RPM у Fedora. |
| Linux (ARM64) | `.AppImage`, `.deb` або `.rpm` | Нативні пакунки для Linux-систем ARM64. |

На Linux Oleafly потребує glibc 2.35 або новішої (часів 2022 року або пізніших: Ubuntu 22.04+, Fedora 36+, Debian 12+).

Не знаєте, який у вас Mac? Відкрийте меню Apple і виберіть **Про цей комп’ютер**. Якщо в рядку **Процесор** указано чип Apple (наприклад, Apple M1), це Apple Silicon; якщо там указано Intel, це Mac на Intel.

Поточні платформи випуску — **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** і **Linux ARM64**. Для Windows на ARM нативного пакунка ще немає.

## Перший запуск

### macOS

Відкрийте образ диска, перетягніть Oleafly до Програм, потім запустіть його. Використовуйте офіційний інсталятор. Якщо macOS блокує його, перевірте **Системні налаштування → Конфіденційність і безпека** на повідомлення про перший запуск.

### Windows

Запустіть MSI або інсталяційний виконуваний файл і дотримуйтеся інсталятора. Якщо Windows показує попередження про репутацію, перед продовженням перевірте, що завантаження походить з офіційного релізу. Інсталятор кладе файл середовища виконання Microsoft Visual C++, потрібний Typst і мовному серверу LaTeX, поруч із застосунком, тож встановлювати його окремо не потрібно.

### Linux

Використовуйте пакунок Debian або RPM із вашим менеджером пакунків або зробіть AppImage виконуваним і відкрийте його:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Oleafly потребує glibc 2.35 або новішої. Виберіть пакунок під архітектуру вашого комп’ютера.

Пакунки `.deb` і `.rpm` тримають власні Tectonic, Pandoc і Typst від Oleafly в `/usr/libexec/oleafly`, тож вони встановлюються поруч із Pandoc вашого дистрибутива. Коли ви запускаєте AppImage, він додає себе до меню програм, що потрібно робочим столам на Wayland, як-от GNOME, щоб показати його піктограму в доці. Він не чіпає меню, коли Oleafly уже додав установлений пакунок чи інший інструмент, а якщо ви видалите запис, той лишиться видаленим.

Пакунок Debian має опис, тож Центр програм Ubuntu показує, що таке Oleafly, перед встановленням. Він також містить дані AppStream, тож центри програм показують піктограму, ліцензію, знімки екрана та версію після встановлення Oleafly. Застосунок з’являється в розділі Офіс у меню програм. На Linux, як і на Windows, Oleafly малює власний рядок заголовка. Його панель інструментів розташована угорі з кнопками згортання, розгортання та закриття. Перетягуйте панель інструментів, щоб перемістити вікно, двічі клацніть її, щоб розгорнути, і тягніть будь-який край або кут, щоб змінити розмір.

## Перша компіляція завантажує пакети TeX

Уперше компілюючи документ на вбудованому рушії Tectonic, Oleafly завантажує пакети, потрібні цьому документу, і кешує їх. Перша компіляція на комп’ютері також одним махом завантажує набір поширених пакетів, тож пізніші документи стартують швидше. Для цього потрібне мережеве з’єднання, і на повільному каналі це може тривати кілька хвилин. Ліміт часу компіляції чекає, поки пакети ще надходять, а якщо дзеркало пакетів Oleafly не відповідає, компіляція переходить на першоджерело. Пізніші компіляції того самого документа швидкі та працюють поза мережею. Документ, якому потрібен пакунок, якого ви ще не кешували, спричиняє ще одне разове завантаження. Див. [Компіляція](/docs/compiling/), зокрема суворий автономний режим.

## Необов’язково: дистрибутив TeX

Tectonic покриває більшість документів. Коли проєкту потрібен pdfLaTeX, upLaTeX або інший компілятор із повного дистрибутива TeX, Oleafly використовує MacTeX, TeX Live, MiKTeX чи TinyTeX, які вже є на вашому комп’ютері. Якщо жодного немає, він може встановити TinyTeX за вас із **Налаштування → Рушії → LaTeX** або прямо з помилки компіляції. TinyTeX не потребує прав адміністратора, завантаження становить близько 250 МБ, а Oleafly просить приблизно 2 ГБ вільного місця на диску.

- У Linux TinyTeX використовує системний Perl. Спершу встановіть його, якщо він відсутній: `sudo apt install perl`, `sudo dnf install perl` або `sudo pacman -S perl`.
- У Windows MiKTeX потребує Perl для запуску `latexmk`. Встановіть Strawberry Perl або TinyTeX, який приносить власний.
- У Debian, Ubuntu і Fedora TeX Live, встановлений через `apt` або `dnf`, також отримує свої пакети LaTeX через `apt` або `dnf`. Oleafly каже, що встановити, але нічого не змінює.

Див. [Рушії та пакунки LaTeX](/docs/latex-engines/#latexmk-and-system-tex).

Ваші файли лишаються звичайними папками на диску. Токени та ключі ШІ зберігаються в зашифрованих локальних файлах, доступних лише власнику. Мережеві функції включають розміщений ШІ, синхронізацію GitHub, завантаження пакунків, пошук цитувань і перевірки оновлень. Див. [Філософію](/docs/philosophy/).

## Актуальні версії

Oleafly перевіряє підписану стрічку релізів, показує нотатки до версії та встановлює на місці, коли ви підтверджуєте. На Linux автоматична заміна працює для встановлень AppImage. Перевірити можна також із **Налаштування → Довідка та про застосунок**. Див. [Оновлення](/docs/updates/).

## Збірка з вихідного коду

Дотримуйтеся [посібника з розробки застосунку](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) щодо передумов, завантаження рушіїв і локальних збірок.

## Наступні кроки

- [Швидкий старт](/docs/getting-started/): від першого проєкту до першого PDF за кілька хвилин.
- [Шаблони](/docs/templates/): вбудовані заготовки та пакунки для завантаження.
- [Oleafly Learn](/learn/): безкоштовний курс із LaTeX та наукового письма в мережі.
- [Інструмент командного рядка](/docs/cli/): збирайте, перевіряйте й синхронізуйте проєкти з термінала та підключайте агентів для програмування.
