---
EdenText est un traitement de texte puissant qui s’utilise dans le navigateur, de la note rapide au livre entier. Ni serveur ni compte : tout est traité en local et vos documents ne quittent jamais votre ordinateur. Il suffit d’ouvrir le lien, ou d’installer EdenText comme application pour l’utiliser hors ligne. Pour la plupart des langues, le premier téléchargement fait environ 2 Mo ; les dictionnaires et les polices sont chargés au besoin[^1]. L’interface est disponible en anglais, allemand, espagnol, français, italien, portugais, grec, russe, ukrainien, japonais et chinois (simplifié et traditionnel).
> [!NOTE]
> EdenText est encore en **bêta** et en développement actif. Des tests et des
> vérifications d’aller-retour en vérifient le fonctionnement. Des bugs restent néanmoins
> possibles à ce stade : gardez des sauvegardes de vos documents importants. Le navigateur
> conserve aussi les trois dernières versions du document ouvert, au cas où il ne se
> chargerait plus.
>
> **Un bug, ou un document qui s’affiche mal ?** Merci
> d’[ouvrir une issue](https://github.com/stffnb/edentext/issues), chaque signalement compte.
> Les documents qui s’affichent autrement dans EdenText que dans Word, LibreOffice ou WPS
> Office nous intéressent particulièrement : joignez le fichier (ou une copie allégée) et
> il deviendra un cas de test.
## Fonctionnalités
- **Une vraie mise en page** – pages A4/Letter, marges, en-têtes et pieds de page, notes
de bas de page, colonnes, numérotation des pages et des lignes, filigranes ; pour les
livres, marges en miroir et chapitres qui commencent sur une page de droite
- **Ouvre et enregistre `.odt` et `.docx`**, exporte en PDF ; modèles (`.ott`/`.dotx`) et
galerie de lettres (DIN 5008) ; fichiers protégés par mot de passe dans les deux formats
- **Compatible avec Word, LibreOffice et WPS Office** – les documents gardent leur mise en
page ; des tests automatisés d’aller-retour et de mise en page le vérifient par rapport
à LibreOffice
- **Styles** – styles de paragraphe, de caractère, de tableau et de liste avec héritage,
numérotation des chapitres
- **Tableaux** avec styles, tri et formules façon tableur
- **Tout ce qu’il faut pour un mémoire ou une thèse** – table des matières, légendes,
renvois, citations et bibliographie, index alphabétique, formules (LaTeX)
- **Outils de révision** – suivi des modifications et fils de commentaires dans des bulles
en marge, comparaison et fusion avec un autre fichier, annotations imprimables, correction orthographique (anglais, allemand,
espagnol, français, italien, portugais, grec, russe et ukrainien), synonymes (toutes ces langues
sauf le grec), correction grammaticale (anglais)
- **Assistant IA facultatif** – avec le fournisseur de votre choix ou un modèle local ; il
répond aux questions sur le document et le modifie avec suivi des modifications. Il
peut être désactivé ; les requêtes vont directement au fournisseur, sans passer par
un serveur EdenText
- **Private by Design** – vos documents ne quittent jamais votre
ordinateur, tout est traité en local ; fonctionne hors ligne comme application
installable. L’éditeur lui-même n’envoie rien, sauf au fournisseur choisi si
l’assistant IA est activé. Les documents sont enregistrés automatiquement dans le
navigateur ; dans « Documents récents », on peut choisir de supprimer les documents
fermés au démarrage suivant ou de ne pas les enregistrer du tout. Une fenêtre de
navigation privée ne laisse aucune trace une fois fermée
- **Tous les navigateurs actuels** – dans Chrome et Edge, « Enregistrer » écrit dans le
fichier ouvert, et Brave aussi une fois `brave://flags/#file-system-access-api` activé ;
sinon, chaque enregistrement est un téléchargement. Pour choisir l’emplacement, il
suffit d’indiquer dans les paramètres du navigateur qu’il doit demander où enregistrer
chaque fichier
Les cas où le navigateur empêche EdenText de reproduire exactement Word ou LibreOffice sont
décrits dans [Known limitations](../../CHANGELOG.md#known-limitations) (en anglais).
## Galerie
Les documents de ces images se trouvent dans [`docs/showcase/`](../showcase/) en
`.odt` et `.docx`, prêts à être ouverts dans EdenText, LibreOffice ou Word. Ils sont générés
par `scripts/showcase/run.mjs` ; les photos viennent de la NASA et le livre est de Lewis
Carroll, tous deux dans le domaine public.
Révision – suivi des modifications, fils de commentaires en marge, filigrane « brouillon »
Livre – A5 avec marges en miroir. Chaque chapitre commence sur une page de droite, l’en-tête affiche le titre du livre sur les pages de gauche et celui du chapitre sur les pages de droite, et la numérotation commence au premier chapitre
Tableaux – styles de tableau et formules façon tableur
## Application de bureau
Chaque version est aussi livrée avec des installateurs de bureau non signés, construits avec Electron :
- **macOS** – `EdenText--arm64.dmg` (Apple Silicon) ou `EdenText-.dmg` (Intel).
Glissez l’application dans Applications. Comme elle n’est pas signée, ouvrez-la la première
fois par clic droit → Ouvrir, ou exécutez `xattr -d com.apple.quarantine /Applications/EdenText.app`.
- **Windows** – `EdenText-Setup-.exe`. SmartScreen signale un éditeur inconnu :
Informations complémentaires → Exécuter quand même.
- **Linux** – `EdenText-.AppImage` (`chmod +x`, puis lancez-le) ou le `.deb`
(`sudo apt install ./edentext_*.deb`).
L’application de bureau ouvre les documents depuis le gestionnaire de fichiers et y
enregistre directement, écrit les PDF sans passer par la boîte de dialogue d’impression et
signale au démarrage qu’une version plus récente est disponible.
## Développement
```bash
npm install
npm run dev # serveur de développement avec rechargement à chaud
npm test # suite de tests
npm run build # build de production → dist/
cd desktop && npm install && npm start # application de bureau sur le même build
```
Construit avec Svelte 5, TypeScript, Vite et TipTap 3 (ProseMirror).
## Auto-hébergement
EdenText n’a pas besoin de backend et ne stocke rien sur le serveur ; les documents
restent dans le navigateur. Une image de conteneur est publiée pour chaque version (amd64
et arm64) :
```bash
docker run -p 8080:80 ghcr.io/stffnb/edentext
```
Sinon, chaque version contient le fichier `edentext-.zip` avec l’application compilée
; `npm run build` produit les mêmes fichiers dans `dist/`. N’importe quel serveur web peut
héberger ce dossier. L’image de conteneur peut aussi être construite localement avec
`docker build -t edentext .`.
Pour Kubernetes, un chart Helm maintenu par la communauté se trouve dans [`charts/edentext`](../../charts/edentext).
Pour une mise à jour, copiez les nouveaux fichiers par-dessus les anciens au lieu de vider
d’abord le dossier. Les onglets ouverts avant la mise à jour continuent de charger les
fichiers de leur version jusqu’à ce qu’ils soient rechargés. Le serveur doit répondre aux
fichiers manquants par une erreur 404 et non par `index.html`, afin que ces onglets
puissent demander à être rechargés.
Nous recommandons de servir EdenText en HTTPS. En HTTP simple, l’éditeur fonctionne aussi,
mais les navigateurs désactivent alors certaines fonctions : l’usage hors ligne,
l’installation comme application, l’enregistrement direct dans le fichier ouvert (il est
téléchargé à la place) et les boutons de copie. Sur localhost, tout fonctionne comme en
HTTPS.
Une version hébergée sur GitHub Pages est librement accessible à tous sur
[edentext.app](https://edentext.app) (elle compte les visites de façon anonyme avec
GoatCounter, hébergé dans l’UE, sans cookies ni adresses IP enregistrées ; l’application
de bureau, l’image de conteneur, l’archive de version et les versions compilées soi-même
ne contiennent aucun compteur).
## Intégration
Une autre application web peut afficher EdenText dans un iframe et gérer elle-même le document.
Avec `?embed=1`, l’éditeur masque sa propre gestion des fichiers. Le module `embed.js`, servi
par chaque instance, y charge des fichiers et les récupère en ODT, DOCX ou PDF ; voir
[docs/architecture/embed.md](../../docs/architecture/embed.md).
L’application hôte peut aussi choisir la langue, le thème et la couleur d’accent, et désactiver l’assistant IA.
En mode intégré, l’éditeur
affiche le logo EdenText et la mention « Powered by EdenText », que les conditions de l’AGPL
obligent à conserver ([NOTICE.md](../../NOTICE.md)) et que seule une compilation en marque
blanche sous [licence commerciale](../../LICENSE.commercial.md) omet (`VITE_EDENTEXT_ATTRIBUTION=off`).
## Architecture
```mermaid
flowchart TD
Browser[Navigateur : application locale, utilisable hors ligne] --> App[Coque de l’application et interface Svelte]
App --> Editor[Éditeur TipTap / ProseMirror]
Editor <--> Document[Document structuré et extensions de l’éditeur]
Document --> Layout[Styles, mise en page, pagination et cadres]
Document <--> Storage[localStorage : documents, paramètres et copies de récupération]
Document <--> Interchange[Import/export ODT et DOCX]
Interchange --> Files[API de fichiers du navigateur, téléchargements et modèles]
Editor --> Tools[Orthographe, grammaire, formules et révision]
Layout --> Render[Pages modifiables dans le navigateur]
```
EdenText fonctionne entièrement dans le navigateur : `App.svelte` assemble l’interface
autour du modèle de document TipTap et de ses extensions. Les styles et la mise en page
transforment ce modèle en pages modifiables ; le stockage conserve l’état local et les
copies de récupération. L’import et l’export traduisent ce même modèle en ODT et DOCX, et
les API de fichiers du navigateur enregistrent ou téléchargent les fichiers obtenus. Les
détails sur les formats et la mise en page se trouvent dans la
[documentation d’architecture](../architecture/) (en anglais).
## Contribuer
Les contributions sont les bienvenues – voir [CONTRIBUTING.md](../../CONTRIBUTING.md) (en
anglais). Pour qu’une pull request soit fusionnée, il faut avoir signé le [CLA](../../CLA.md) ; c’est
vérifié automatiquement.
### Remerciements
Merci à toutes celles et tous ceux qui ont aidé par leurs idées, leurs signalements de
bugs, leurs tests et leurs retours. Outre les contributeurs listés sur GitHub, je
remercie également :
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)