---
EdenText — потужний текстовий процесор у браузері для всього: від швидких нотаток до цілих книжок. Без сервера й без облікового запису — усе обробляється локально, і документи ніколи не залишають комп’ютера. Досить відкрити посилання або встановити EdenText як застосунок і працювати офлайн. Для більшості мов під час першого запуску завантажується близько 2 МБ, а словники й шрифти довантажуються за потреби[^1]. Інтерфейс доступний англійською, німецькою, іспанською, французькою, італійською, португальською, грецькою, російською, українською, японською та китайською (спрощеною й традиційною) мовами.
> [!NOTE]
> EdenText поки що в **беті** й активно розвивається. Тести й перевірки обміну
> підтверджують його роботу. Проте на цьому етапі помилки не виключені, тож зберігайте резервні копії важливих документів. Крім того, браузер зберігає три
> останні версії відкритого документа на випадок, якщо він не завантажиться.
>
> **Знайшли помилку або документ виглядає не так, як має?** Будь ласка,
> [створіть issue](https://github.com/stffnb/edentext/issues), це дуже допомагає.
> Особливо цінні документи, які в EdenText виглядають інакше, ніж у Word, LibreOffice чи
> WPS Office: додайте файл (або скорочену копію), і він стане тестовим прикладом.
## Можливості
- **Справжня верстка сторінок** — сторінки A4/Letter, поля, колонтитули, виноски, колонки,
нумерація сторінок і рядків, водяні знаки; для книжок — дзеркальні поля й розділи, що
починаються з правої сторінки
- **Відкриває та зберігає `.odt` і `.docx`**, експортує в PDF; шаблони (`.ott`/`.dotx`)
і галерея листів (DIN 5008); захищені паролем файли в обох форматах
- **Сумісність із Word, LibreOffice і WPS Office** — документи зберігають верстку;
автоматичні тести обміну й верстки перевіряють це за LibreOffice
- **Стилі** — стилі абзаців, символів, таблиць і списків зі спадкуванням, нумерація розділів
- **Таблиці** зі стилями, сортуванням і формулами, як в електронних таблицях
- **Усе для дипломної роботи чи дисертації** — зміст, підписи, перехресні посилання,
цитування й список літератури, предметний покажчик, формули (LaTeX)
- **Рецензування** — відстеження змін і гілки коментарів у виносках на полях, порівняння й об’єднання з іншим файлом, друк
виправлень, перевірка орфографії (англійська, німецька, іспанська, французька, італійська,
португальська, грецька, російська та українська), синоніми (усі ці мови, крім
грецької), перевірка граматики (англійська)
- **Необов’язковий ШІ-асистент** — з будь-яким провайдером на вибір або локальною моделлю;
відповідає на запитання про документ і редагує його з відстеженням змін. Його можна
вимкнути; запити йдуть безпосередньо до провайдера, без сервера EdenText
- **Private by Design** — документи ніколи не залишають комп’ютера, усе обробляється
локально; після встановлення застосунок працює офлайн. Сам редактор нічого не надсилає, окрім запитів
до обраного провайдера, коли ввімкнено ШІ-асистента. Документи автоматично зберігаються
в браузері; в «Останніх документах» можна налаштувати, щоб закриті документи видалялися
під час наступного запуску або взагалі не зберігалися. Приватне вікно після закриття не
залишає слідів
- **Будь-який сучасний браузер** — у Chrome і Edge «Зберегти» записує зміни у відкритий
файл, у Brave теж — після ввімкнення `brave://flags/#file-system-access-api`; в інших
випадках кожне збереження — це завантаження. Щоб обирати місце, увімкніть у
налаштуваннях браузера «Запитувати, де зберігати кожен файл перед завантаженням»
Де браузер не дає EdenText точно відтворити Word чи LibreOffice, описано в розділі
[Known limitations](../../CHANGELOG.md#known-limitations) (англійською).
## Галерея
Документи, з яких зроблено ці зображення, лежать у [`docs/showcase/`](../showcase/)
у форматах `.odt` і `.docx` — їх можна одразу відкрити в EdenText, LibreOffice чи Word.
Їх створює скрипт `scripts/showcase/run.mjs`; фотографії належать NASA, а книжка —
Льюїсу Керроллу, усе це суспільне надбання.
Рецензування — відстеження змін, гілки коментарів на полях, водяний знак «чернетка»
Книжка — A5 із дзеркальними полями. Кожен розділ починається з правої сторінки, у верхньому колонтитулі на лівих сторінках стоїть назва книжки, на правих — назва розділу, а нумерація сторінок починається з першого розділу
Бюлетень — колонки, зображення з підписами, бічна врізка
Таблиці — стилі таблиць і формули, як в електронних таблицях
## Настільний застосунок
До кожного релізу також додаються непідписані інсталятори, зібрані на Electron:
- **macOS** — `EdenText--arm64.dmg` (Apple Silicon) або `EdenText-.dmg` (Intel).
Перетягніть застосунок у «Програми». Оскільки він не підписаний, уперше відкрийте його
через правий клік → «Відкрити» або виконайте `xattr -d com.apple.quarantine /Applications/EdenText.app`.
- **Windows** — `EdenText-Setup-.exe`. SmartScreen попередить про невідомого
видавця: «Докладніше» → «Усе одно запустити».
- **Linux** — `EdenText-.AppImage` (`chmod +x`, потім запустіть) або `.deb`
(`sudo apt install ./edentext_*.deb`).
Настільний застосунок відкриває документи з файлового менеджера й зберігає зміни просто в
той самий файл, записує PDF напряму без діалогу друку й під час запуску повідомляє про
вихід нової версії.
## Розробка
```bash
npm install
npm run dev # dev-сервер із гарячим перезавантаженням
npm test # набір тестів
npm run build # продакшн-збірка → dist/
cd desktop && npm install && npm start # настільний застосунок на тій самій збірці
```
Створено на Svelte 5, TypeScript, Vite і TipTap 3 (ProseMirror).
## Власний хостинг
EdenText не потребує бекенду й нічого не зберігає на сервері; документи залишаються в
браузері. Для кожного релізу публікується образ контейнера (amd64 і arm64):
```bash
docker run -p 8080:80 ghcr.io/stffnb/edentext
```
Крім того, до кожного релізу додається файл `edentext-.zip` зі зібраним застосунком;
`npm run build` створює ті самі файли в `dist/`. Цю теку можна розмістити на будь-якому
вебсервері. Образ контейнера можна також зібрати локально командою
`docker build -t edentext .`.
Для Kubernetes у [`charts/edentext`](../../charts/edentext) є Helm-чарт, який підтримує спільнота.
Під час оновлення скопіюйте нові файли поверх старих, не очищаючи теку заздалегідь.
Вкладки, відкриті до оновлення, і далі завантажують файли своєї версії, доки їх не
перезавантажать. На запит відсутнього файлу сервер має відповідати 404, а не `index.html`,
щоб такі вкладки могли запропонувати перезавантаження.
Радимо розміщувати EdenText через HTTPS. Через звичайний HTTP редактор теж працює, але
браузери тоді вимикають деякі функції: роботу офлайн, встановлення як застосунку,
збереження просто у відкритий файл (натомість він завантажується) і кнопки копіювання. На
localhost усе працює так само, як через HTTPS.
На [edentext.app](https://edentext.app) є версія на GitHub Pages, вільно доступна всім
(він анонімно рахує відвідування за допомогою GoatCounter — хостинг у ЄС, без cookie,
IP-адреси не зберігаються; у настільному застосунку, образі контейнера, архіві релізу та
власній збірці лічильника немає).
## Вбудовування
Інший вебзастосунок може показати EdenText в iframe і сам зберігати документ. З параметром
`?embed=1` редактор приховує власне керування файлами. Помічник `embed.js`, який роздає кожен
екземпляр, завантажує файли й отримує їх назад у форматі ODT, DOCX або PDF; див.
[docs/architecture/embed.md](../../docs/architecture/embed.md).
Застосунок-хост може також задати мову, тему й колір акценту та вимкнути ШІ-асистента.
У режимі вбудовування редактор
показує логотип EdenText і напис «Powered by EdenText», які умови AGPL вимагають зберігати
([NOTICE.md](../../NOTICE.md)) і які прибирає лише white-label-збірка за
[комерційною ліцензією](../../LICENSE.commercial.md) (`VITE_EDENTEXT_ATTRIBUTION=off`).
## Архітектура
```mermaid
flowchart TD
Browser[Браузер: локальний застосунок, що працює офлайн] --> App[Оболонка застосунку й інтерфейс на Svelte]
App --> Editor[Редактор TipTap / ProseMirror]
Editor <--> Document[Структурований документ і розширення редактора]
Document --> Layout[Стилі, верстка, розбиття на сторінки й рамки]
Document <--> Storage[localStorage: документи, налаштування й резервні копії]
Document <--> Interchange[Імпорт та експорт ODT і DOCX]
Interchange --> Files[Файлові API браузера, завантаження й шаблони]
Editor --> Tools[Орфографія, граматика, формули й рецензування]
Layout --> Render[Сторінки в браузері, які можна редагувати]
```
EdenText працює повністю в браузері: `App.svelte` будує інтерфейс навколо моделі
документа TipTap та її розширень. Стилі й верстка перетворюють цю модель на сторінки,
які можна редагувати; сховище тримає локальний стан і резервні копії. Імпорт та експорт
перекладають ту саму модель у ODT і DOCX, а файлові API браузера зберігають або
завантажують отримані файли. Докладніше про формати й верстку — в
[архітектурній документації](../architecture/) (англійською).
## Участь у розробці
Внески вітаються — див. [CONTRIBUTING.md](../../CONTRIBUTING.md) (англійською). Для злиття
потрібно підписати [CLA](../../CLA.md); це автоматично перевіряється в кожному pull request.
### Подяки
Дякую всім, хто допоміг ідеями, повідомленнями про помилки, тестуванням і відгуками. Окрім учасників, зазначених на GitHub, хочу також подякувати:
Patrick R., [@Deleh](https://github.com/Deleh), [@lukasmwerner](https://github.com/lukasmwerner), [@JinJieBeWater](https://github.com/JinJieBeWater), [@farragoo](https://github.com/farragoo), [@sbvelinga](https://github.com/sbvelinga)