Éditeur de documents — Guide utilisateur

À quoi sert le module « Docs »

Le module est un éditeur rich-text complet à l'intérieur de YoBench pour wikis internes, notes personnelles et documentation projet. Sous le capot — TipTap sur ProseMirror : menu de commandes /, vaste palette de blocs, diagrammes Mermaid et Draw.io, formules KaTeX, wiki-liens entre pages, historique des versions et assistant IA.

Ce que vous obtenez :

Hiérarchie de pages — documents imbriqués avec arbre dans la barre latérale et fil d'Ariane.
Éditeur riche — titres, listes de tâches, tableaux, citations, blocs de code avec coloration syntaxique (28 langages), callouts, toggles, table des matières, find & replace, sélecteur d'emojis.
Diagrammes et formules — Mermaid, Draw.io (interactif), KaTeX.
Médias — images redimensionnables, embed YouTube/Vimeo, pièces jointes.
Wiki-liens — [[Nom de page]] avec autocomplétion ; backlinks suivis automatiquement.
Historique des versions — jusqu'à 50 snapshots par page avec restauration.
Assistant IA — Summarize, Continue Writing, Translate (8 langues), Improve Text.
Export/import — Markdown, HTML, archives ZIP ; l'import .md crée une nouvelle page.
Stockage local — toutes les pages et versions dans la base chiffrée de YoBench.
Favoris et corbeille paginés — les longues listes de pages favorites ou supprimées se chargent par pages, la barre latérale reste réactive.

Paramètres de page

À la création ou édition :

Titre — nom affiché.
Icône — emoji depuis le picker.
Image de couverture — URL (optionnel).
Parent — pour l'imbrication.
Drapeaux — favori, supprimé (corbeille), modèle.

Les tags et catégories ne sont pas implémentés — la structuration passe par la hiérarchie et les favoris.

Fonctionnalités de l'éditeur

Mise en forme

Gras, italique, souligné, barré, code en ligne.
Couleur de texte, surlignage, indice et exposant.
Alignement (gauche / centre / droite).

Blocs structurels

Titres H1, H2, H3.
Listes à puces et numérotées.
Listes de tâches avec cases à cocher.
Citations, blocs de code (28 langages, lowlight).
Tableaux avec édition des cellules.
Séparateurs horizontaux.
Blocs callout : Info / Warning / Success / Error.
Blocs toggle (repliables).
Table des matières dynamique (TOC).

Blocs avancés

Wiki-liens — [[Nom de page]] avec autocomplétion sur les pages existantes.
Mermaid — diagrammes en code.
Draw.io — éditeur vectoriel interactif.
KaTeX — math en ligne et en bloc.
Vidéo — embed YouTube/Vimeo.
Images — upload drag-and-drop avec redimensionnement.
Pièces jointes — fichiers arbitraires attachés à la page.

Commandes slash

Tapez / dans l'éditeur — un menu d'insertions rapides s'ouvre : /heading1, /heading2, /heading3, /bulletList, /taskList, /table, /image, /codeBlock, /math, /mermaid, /drawio, /video, /quote, /toggle, /toc, /divider et plus.

Find & Replace, sélecteur d'emojis

Recherche-remplacement standard plus sélecteur d'emojis depuis la barre d'outils.

Historique des versions

Un snapshot (docs_page_versions) est créé automatiquement quand vous passez à une autre page.
Jusqu'à 50 versions par page sont conservées ; les plus anciennes sont supprimées.
Le panneau Historique des versions liste les snapshots avec horodatage ; Restaurer rend la version choisie courante, et l'état précédent est sauvegardé comme nouvelle version.

Assistant IA

La barre d'outils a un bouton « auto-amélioration ». Actions disponibles :

Summarize — résumé court du texte sélectionné ou de la page entière.
Continue Writing — continue le texte dans le même style.
Translate — traduit vers 8 langues (anglais, russe, allemand, espagnol, français, portugais, chinois, japonais).
Improve Text — améliore la grammaire et la clarté.

Les résultats peuvent s'insérer à la position du curseur ou remplacer la sélection. Le fournisseur IA vient des réglages globaux du module.

Export et import

Markdown (.md) — export de la page courante.
HTML (.html) — export avec styles inline.
ZIP (Markdown) — toutes les pages en .md.
ZIP (HTML) — toutes les pages en .html.
Import .md — crée une nouvelle page depuis un fichier.
Envoyer dans un contexte — pousser le contenu de la page dans Context Manager & RAG pour une recherche IA ultérieure.

Réglages globaux

Sous Réglages → Docs :

Fournisseur IA pour Docs (docsAiProviderId) — quel fournisseur du registre AI Chat anime Summarize / Continue / Translate / Improve.

Flux d'utilisation

1. Créez votre première page

Ouvrez le module Docs depuis le menu de gauche.
Dans la sidebar cliquez sur + Nouvelle page.
Saisissez un titre et choisissez optionnellement une icône.
Ouvrez la page.

2. Écrivez le contenu

Tapez le texte ; / ouvre le menu slash.
Glissez des fichiers directement dans l'éditeur pour les pièces jointes et images.
Utilisez [[]] pour un wiki-lien vers une autre page.

3. Construisez la structure

Glissez les pages dans la sidebar pour changer la hiérarchie.
Marquez les pages utilisées souvent comme Favoris.

4. Utilisez l'assistant IA

Sélectionnez du texte → bouton IA dans la barre d'outils → choisissez une action. Le résultat s'insère ou remplace la sélection.

5. Revenez à une version

Ouvrez le panneau Historique des versions → choisissez un snapshot → Restaurer. Le contenu actuel est conservé comme une autre version.

6. Exportez

Menu de la page → Exporter → choisissez un format. Pour tout l'arbre — Exporter ZIP.

Étapes suivantes

Connectez les fournisseurs IA pour que l'assistant IA fonctionne.
Poussez votre doc dans les Contextes & RAG pour que AI Chat y réponde.
Pour les mind maps et whiteboarding, utilisez Board.

Aide et retour

Vous voulez les tags, l'édition collaborative ou plus de formats d'export ? Contactez-nous via le formulaire de retour.