From 9aade51fcc956762c5a3f65c0e21a9063cb591e7 Mon Sep 17 00:00:00 2001
From: Edern Deneuville <edern.deneuville@gmail.com>
Date: Fri, 11 Sep 2026 14:28:59 +0200
Subject: [PATCH] Document explicit Word equation markers

---
 README.md | 43 ++++++++++++++++++++++++++++---------------
 1 file changed, 28 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 6880e13..c677253 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ Copiez `config.json.template` vers `config.json` puis adaptez :
   "server_url": "http://localhost:11434",
   "hotkey": "ctrl+alt+a",
   "request_timeout_seconds": 300,
-  "math_text_format": "word_equation"
+  "math_text_format": "plain"
 }
 ```
 
@@ -69,28 +69,41 @@ Copiez `config.json.template` vers `config.json` puis adaptez :
 
 `request_timeout_seconds` vaut `300` par défaut. Si Ollama charge un gros modèle ou répond lentement, augmentez cette valeur. Mettez `0` pour désactiver le timeout côté application.
 
-### Formatage mathématique Word
+### Mode mathématique Word
 
-`math_text_format` vaut `word_equation` par défaut. Dans ce mode, les segments mathématiques comme `z_1`, `x^2`, `\alpha` ou `z_1 = x + iy` sont injectés dans Word comme de vraies équations :
+La configuration générale reste simple (`math_text_format: "plain"`). Pour les réponses mathématiques, utilisez l'exemple dédié :
 
-1. l'application envoie `Alt+=` ;
-2. elle tape l'expression en syntaxe UnicodeMath Word ;
-3. elle envoie `Espace` pour laisser Word convertir ;
-4. elle sort de l'objet équation avec `Flèche droite`.
-
-Exemple :
-
-```text
-On pose z_1 = x + iy.
+```bash
+cp config.math-word.template config.json
 ```
 
-est injecté comme texte normal `On pose `, puis une équation Word `z_1 = x + iy`, puis le point final.
+Ce fichier active :
+
+```json
+"math_text_format": "word_equation"
+```
+
+Dans ce mode, l'application ne devine plus les maths automatiquement. Elle suit uniquement les balises explicites renvoyées par le modèle :
+
+```text
+La solution est [EQ]z_1 = x + iy[/EQ].
+```
+
+Injection réelle :
+
+1. texte normal : `La solution est ` ;
+2. à `[EQ]`, l'application envoie `Alt+=` ;
+3. elle tape `z_1 = x + iy` dans l'éditeur d'équation Word ;
+4. à `[/EQ]`, elle envoie `Espace` puis `Flèche droite` pour convertir et sortir de l'équation ;
+5. elle reprend le texte normal : `.`.
+
+Le prompt de `config.math-word.template` demande aussi au modèle d'éviter le LaTeX non souhaité, notamment `\\frac`, `\\dfrac`, `\\tfrac`, `\\left`, `\\right`, `$`, `$$`, `\\(` et `\\[`.
 
 Modes disponibles :
 
-- `word_equation` : crée des objets Équation Word via `Alt+=` pour les segments mathématiques détectés.
-- `unicode` : transforme `z_1`, `x^2`, `\alpha`, etc. en texte Unicode (`z₁`, `x²`, `α`) sans objet équation.
 - `plain` : injecte la réponse exactement telle que le modèle l'a renvoyée.
+- `word_equation` : crée des objets Équation Word uniquement pour les blocs `[EQ]...[/EQ]`.
+- `unicode` : ancien mode texte Unicode (`z_1` → `z₁`, `x^2` → `x²`) sans objet équation.
 
 ## Compilation