---
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)