living-documentation 7.0.0

package/dist/starting-doc/.living-doc.json

@@ -0,0 +1,39 @@
+{
+  "docsFolder": "/Users/ymedaghri/Documents/Repositories/Medaghri-Alaoui-Repositories/09_My_Published_Projects/living-documentation/starting-doc",
+  "filenamePattern": "YYYY_MM_DD_HH_mm_[Category]_title",
+  "title": "Living Documentation",
+  "theme": "system",
+  "language": "fr",
+  "port": 4321,
+  "extraFiles": [],
+  "showDiagramDebug": false,
+  "diagramNodePalette": [
+    "#ffffff",
+    "#f5f5f4",
+    "#f1f5f9",
+    "#dbeafe",
+    "#e0f2fe",
+    "#cffafe",
+    "#ccfbf1",
+    "#dcfce7",
+    "#ecfccb",
+    "#fef9c3",
+    "#ffedd5",
+    "#fee2e2",
+    "#ffe4e6",
+    "#fce7f3",
+    "#ede9fe"
+  ],
+  "diagramEdgePalette": [
+    "#ffffff",
+    "#a8a29e",
+    "#374151",
+    "#3b82f6",
+    "#14b8a6",
+    "#22c55e",
+    "#f97316",
+    "#ef4444",
+    "#a855f7"
+  ],
+  "sourceRoot": "/Users/ymedaghri/Documents/Repositories/Medaghri-Alaoui-Repositories/09_My_Published_Projects/living-documentation"
+}

package/dist/starting-doc/1_tutorial/2026_04_11_13_25_[General]_crer_vos_dossiers.md

@@ -0,0 +1,16 @@
+## Introduction
+
+Les dossiers constituent l'architecture de votre documentation.<br/>
+Cette architecture doit répondre à une question simple : **où cherchera-t-on cette information dans six mois ?**<br/>
+Pour en savoir plus sur les façons d'architecturer votre documentation, [suivez ce lien](?doc=4_reference%252F2026_04_11_17_31_%255BFUNDAMENTALS%255D_architecturer_une_documentation)
+
+## Passons à la pratique
+
+1. Dans un nouveau projet, vous pouvez créer des dossiers avec le bouton correspondant en haut, dans le Menu latéral de gauche.<br/>
+   `Shift+CLIC pour agrandir l'image`
+
+   [![Créer Vos Dossiers (Tutoriel)](https://images.unsplash.com/photo-1472190649224-495422e1b602?q=80&w=1471&auto=format&fit=crop&ixlib=rb-4.1.0&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D)](/diagram?id=d1775917727566)
+
+2. Créer un second dossier **2_GUIDE** puis **3_CONCEPT** et enfin **4_REFERENCE**<br/>
+💡 Vos dossier apparaissent ordonnée car ils utilisent un **préfix** "1_", "2_", "3_", ..., mais ce dernier est invisible en affichage
+   ![image](./images/quatre-dossiers-crees.png)

package/dist/starting-doc/1_tutorial/2026_04_11_18_58_[General]_creer_un_document_dans_un_dossier.md

@@ -0,0 +1,9 @@
+1. Créer un document
+[![Créer un document](./images/cr_er_un_document.png)](/diagram?id=d1776024969304)
+
+2. Créer un document dans un dossier contenant déjà un document
+<br/>Pour cela sélectionnez d'abord **un document existant dans le Menu latéral de gauche** puis cliquez sur le bouton en haut.<br/>
+Vous constaterez que les champs `Category`et `Location` sont **préremplis**, vous pouvez ainsi facilement et rapidement ajouter un ensemble de documents dans un dossier et/ou une catégorie donnés.<br/>
+Pour en savoir plus sur les notions de **dossiers** et de **catégories**, [suivez ce lien](?doc=4_reference%252F2026_04_12_14_07_%255BFUNDAMENTALS%255D_dossiers_et_catgories)
+
+[![Ajouter Un Document Dans Un Dossier](./images/ajouter_un_document_dans_un_dossier.png)](/diagram?id=d1775937972731)

package/dist/starting-doc/1_tutorial/2026_04_12_09_00_[General]_editer_et_sauvegarder.md

@@ -0,0 +1,39 @@
+## Introduction
+
+Living Documentation vous permet d'éditer vos fichiers Markdown directement dans le navigateur, sans quitter l'outil ni ouvrir un éditeur de code. Les modifications sont sauvegardées sur disque instantanément.
+
+## Passons à la pratique
+
+1. **Ouvrez n'importe quel document** dans la barre latérale gauche.
+
+2. **Cliquez sur le bouton `Edit`** dans le header de l'article (en haut à droite du contenu).
+
+   Le document bascule en mode édition : un `<textarea>` remplace le rendu HTML. Vous voyez le Markdown brut.
+
+3. **Modifiez le texte.** Par exemple, ajoutez une ligne à la fin :
+
+   ```markdown
+   Voici ma première modification !
+   ```
+
+4. **Cliquez sur `Save`.**
+
+   Le document est sauvegardé sur disque et re-rendu immédiatement, sans rechargement de page.
+
+   ✅ Votre modification est visible et persistée dans le fichier `.md` sur le disque.
+
+5. **Pour annuler sans sauvegarder**, cliquez sur `Cancel` — le document revient à son état d'origine.
+
+---
+
+## Astuce — coller une image
+
+En mode édition, vous pouvez coller une image directement depuis le presse-papiers :
+
+1. Copiez une image (capture d'écran, image depuis un navigateur…)
+2. Placez le curseur à l'endroit souhaité dans le textarea
+3. Faites `Cmd+V` (Mac) ou `Ctrl+V` (Windows/Linux)
+
+Un placeholder `![image](uploading...)` apparaît immédiatement, puis est remplacé par le lien définitif une fois l'upload terminé.
+
+> L'image est sauvegardée dans `DOCS_FOLDER/images/` avec un nom généré automatiquement.

package/dist/starting-doc/1_tutorial/2026_04_12_10_00_[General]_utiliser_les_snippets.md

@@ -0,0 +1,71 @@
+## Introduction
+
+Les **snippets** sont des modèles Markdown prêts à l'emploi que vous insérez au curseur en un clic. Ils évitent de taper à la main les syntaxes complexes (tableaux, blocs dépliables, arbres ASCII…).
+
+## Prérequis
+
+Être en mode **édition** sur un document. Si ce n'est pas le cas, [éditez d'abord un document](?doc=1_tutorial%252F2026_04_12_09_00_%255BGeneral%255D_editer_et_sauvegarder).
+
+## Passons à la pratique
+
+### Insérer un snippet simple
+
+1. En mode édition, **positionnez votre curseur** à l'endroit où vous voulez insérer le snippet.
+
+2. **Cliquez sur `🧩 Snippets`** dans la barre d'outils de l'éditeur.
+
+   Un panneau s'ouvre à droite avec la liste des snippets disponibles.
+
+3. Choisissez **`Bloc dépliable`** (`<details>`).
+
+   Des champs apparaissent : *Titre du bloc* et *Contenu*.
+
+4. Remplissez :
+   - Titre : `Voir les détails`
+   - Contenu : `Voici le contenu caché.`
+
+5. Cliquez sur **`Insérer`**.
+
+   ✅ Le snippet est inséré au curseur :
+
+   ```markdown
+   <details><summary>Voir les détails</summary>
+
+   Voici le contenu caché.
+   </details>
+   ```
+
+---
+
+### Insérer un tableau avec l'éditeur de tableau
+
+1. Cliquez sur **`🧩 Snippets`** → choisissez **`Tableau`**.
+
+2. Définissez le nombre de colonnes (ex. 3) et de lignes (ex. 2).
+
+3. Remplissez les cellules dans la grille interactive.
+
+4. Cliquez **`Insérer`**.
+
+   ✅ Un tableau Markdown aligné est généré :
+
+   ```markdown
+   | Colonne 1 | Colonne 2 | Colonne 3 |
+   |-----------|-----------|-----------|
+   | val 1     | val 2     | val 3     |
+   | val 4     | val 5     | val 6     |
+   ```
+
+---
+
+### Mode détection — modifier un snippet existant
+
+1. **Sélectionnez** dans le textarea un snippet déjà présent (par exemple, un bloc `<details>…</details>` entier).
+
+2. **Cliquez sur `🧩 Snippets`**.
+
+   Si le snippet est reconnu, un message vert s'affiche et les champs sont **pré-remplis** avec les valeurs existantes.
+
+3. Modifiez les champs, puis cliquez **`Insérer`** pour remplacer la sélection.
+
+> Si la sélection n'est pas reconnue, un message orange l'indique et le panneau reste vide.

package/dist/starting-doc/2026_04_08_20_52_[General]_welcome.md

@@ -0,0 +1,17 @@
+# Living Documentation — Guide d'utilisation
+
+> La documentation est un problème que presque tout le monde a résolu en faisant semblant de l'avoir résolu.
+>
+> — Nobody
+
+Des README squelettiques, des outils documentaires tels que Notion et Confluence devenant des forêts vierges où personne ne rentre plus, où on passe du temps à faire un `Ctrl+F` global sur tous les espaces pour finalement ne rien trouver, ou pire, trouver quelque chose d'obsolète mais on va faire avec.
+
+Au bout d'un moment, on n'y va plus du tout, et la connaissance redevient individuelle.
+
+Ca en arrange certains ? Pas moi !
+
+# Pourtant certaines approches ont prouvé leur valeur
+
+[![Découvrons les ADRs](./images/decouverte_adrs.png)](?doc=3_concept%252F2026_04_08_20_58_%255BDOCUMENTING%255D_ADRS)
+
+<h1 style="text-align:center"><code>CLIC sur l'image pour naviguer 😉</code></h1>

package/dist/starting-doc/2026_04_11_12_55_[General]_premiers_pas.md

@@ -0,0 +1,271 @@
+Pour vos premiers pas avec l'outil je vous recommande de suivre les différents tutoriels que vous trouverez listés dans le tableau ci-après.
+
+Pour la réalisation de ces tutoriels je vous recommande également :
+- Soit de lancer une nouvelle instance d'un projet vide **(à l'aide de la commande ic-dessous)** et de l'ouvrir **ensuite** dans un <a href="http://localhost:1234/" target="_blank">un nouvel onglet</a>, ce qui rendra la réalisation des tutoriels plus pratique 
+  ```bash
+  npx living-documentation -p 1234 ./votre-dossier-pour-pratiquer
+  ```
+- Soit d'utiliser le projet **actuel** `living-documentation` de `démo` mais néanmoins  d'ouvrir <a href="/" target="_blank">un nouvel onglet</a>  pour y réaliser vos tutoriels, ce qui rendra la réalisation des tutoriels plus pratique
+
+## Tutoriels disponibles
+
+| Tutoriels | Description |
+| --------- | --------- |
+| [Créez vos dossiers](?doc=1_tutorial%252F2026_04_11_13_25_%255BGeneral%255D_crer_vos_dossiers)         | Apprenez à créer et à structurer vos dossiers         |
+| [Créer un document dans un dossier](?doc=1_tutorial%252F2026_04_11_18_58_%255BGeneral%255D_creer_un_document_dans_un_dossier)         | Comment ajouter un document à un dossier existant         |
+| [Éditer et sauvegarder un document](?doc=1_tutorial%252F2026_04_12_09_00_%255BGeneral%255D_editer_et_sauvegarder)         | Modifier le contenu d'un document directement dans le navigateur         |
+| [Utiliser les snippets](?doc=1_tutorial%252F2026_04_12_10_00_%255BGeneral%255D_utiliser_les_snippets)         | Insérer des modèles Markdown prêts à l'emploi (tableaux, blocs, arbres…)         |
+
+## Manuel d'utilisation
+
+
+
+## Convention de nommage des fichiers
+
+Les fichiers Markdown doivent suivre ce pattern par défaut :
+
+```
+YYYY_MM_DD_HH_mm_[Categorie]_titre_du_document.md
+```
+
+Exemple :
+
+```
+2024_03_15_10_30_[Architecture]_choix_base_de_donnees.md
+2024_03_15_14_00_[Tutoriel]_premiers_pas.md
+```
+
+Le pattern est entièrement configurable depuis le panneau Admin. L'outil reconnaît les tokens `YYYY`, `MM`, `DD`, `HH`, `mm`, et `[Category]`.
+
+> **Contrainte** : le pattern doit contenir `[Category]` exactement une fois.
+
+---
+
+## Organisation des documents
+
+Les documents sont organisés en **catégories** (extraites du nom de fichier) et en **sous-dossiers** (reflétant l'arborescence du système de fichiers).
+
+Dans la barre latérale :
+
+- La catégorie **General** apparaît toujours en premier
+- Les **sous-dossiers** sont affichés ensuite, triés alphabétiquement — un préfixe numérique (`1_`, `2_`) permet de contrôler l'ordre
+- Les autres **catégories** suivent, triées alphabétiquement
+
+---
+
+## Fonctionnalités
+
+### Lecture et navigation
+
+- **Deep links** : chaque document a une URL stable (`?doc=id`) que vous pouvez partager ou mettre en favori
+- **Recherche instantanée** : filtre par titre et catégorie côté client, puis recherche plein texte côté serveur (350 ms de délai)
+- **Ancres** : les titres `## Mon titre` génèrent automatiquement des ancres navigables
+- **Mode pleine page** : bouton *Pleine page* pour masquer la sidebar
+
+### Édition
+
+- Cliquez sur **Edit** pour éditer le Markdown brut directement dans le navigateur
+- **Cmd/Ctrl+V** avec une image dans le presse-papiers : l'image est uploadée automatiquement dans `DOCS_FOLDER/images/` et le lien est inséré
+- **Save** re-rend le document sans recharger la page
+
+### Export PDF
+
+- **Export PDF (article courant)** : bouton dans le header de l'article, imprime le document affiché
+- **Export PDF (tous les documents)** : bouton *📄 PDF* en haut de la barre latérale — génère un PDF complet avec table des matières et liens inter-documents fonctionnels
+
+### Diagrammes
+
+Créez des diagrammes interactifs via **⬡ Diagram** dans le header. Les diagrammes peuvent être liés à des articles via le bouton *⬡ Diagram* de l'éditeur. Un clic sur l'image du diagramme dans un article ouvre l'éditeur de diagramme.
+
+### Word Cloud
+
+Le bouton *☁ Word Cloud* permet de générer un nuage de mots à partir de n'importe quel dossier de votre système de fichiers — utile pour visualiser les thèmes dominants d'une base de code ou d'une documentation.
+
+### Admin
+
+Accessible via **⚙ Admin** dans le header. Permet de configurer :
+
+- Le titre de l'application
+- Le thème
+- Le pattern de nommage des fichiers
+- Les fichiers supplémentaires (*Extra files* — fichiers Markdown situés en dehors du dossier principal)
+- Le mode debug des diagrammes
+
+---
+
+## Recommandation : écrire avec la méthode Diátaxis
+
+> "Un document, une seule orientation."
+
+La documentation non structurée accumule du contenu hétérogène qui finit par ne plus servir personne. La méthode **Diátaxis** propose un cadre simple : chaque document appartient à exactement **un des quatre quadrants**, définis par deux axes.
+
+### Les deux axes
+
+```
+                    APPRENTISSAGE
+                         │
+         Tutoriel        │          Explication
+    (pratique+apprendre) │     (théorique+apprendre)
+                         │
+PRATIQUE ────────────────┼──────────────── THÉORIQUE
+                         │
+       Guide pratique    │         Référence
+   (pratique+appliquer)  │    (théorique+appliquer)
+                         │
+                    APPLICATION
+```
+
+---
+
+### Quadrant 1 — Tutoriel
+
+**Question clé :** *"Peux-tu m'apprendre à… ?"*
+
+Un tutoriel guide un **débutant** pas à pas vers un résultat concret. Il ne suppose aucune connaissance préalable. L'objectif n'est pas d'expliquer *pourquoi* les choses fonctionnent, mais de faire réussir l'apprenant.
+
+**Caractéristiques :**
+- Étapes numérotées, courtes, testées
+- Résultat visible et vérifiable à chaque étape
+- Environnement propre (n'assume rien d'installé)
+- Captures d'écran si besoin
+- Durée : 5 à 15 minutes
+
+**Exemple dans une documentation produit :**
+
+```
+## Créer votre premier document
+
+1. Créez un dossier `docs/` dans votre projet
+2. Lancez `npx living-documentation ./docs`
+3. Ouvrez http://localhost:4321 dans votre navigateur
+4. Cliquez sur **+** dans la barre latérale
+5. Saisissez le titre "Mon premier document" et cliquez **Create**
+
+✅ Votre document apparaît dans la sidebar sous la catégorie General.
+```
+
+---
+
+### Quadrant 2 — Guide pratique (*How-to*)
+
+**Question clé :** *"Comment faire… ?"*
+
+Un guide pratique aide un utilisateur qui **sait déjà ce qu'il veut faire** mais a besoin des étapes pour y arriver. Contrairement au tutoriel, il suppose un contexte existant et va droit au but.
+
+**Caractéristiques :**
+- Prérequis listés en tête
+- Étapes ordonnées vers un objectif précis
+- Variantes et alternatives mentionnées
+- Erreurs courantes anticipées
+- Pas d'explications conceptuelles
+
+**Exemple :**
+
+```
+## Comment configurer un pattern de nommage personnalisé
+
+**Prérequis** : Living Documentation démarré, accès à Admin
+
+1. Ouvrez **⚙ Admin**
+2. Dans le champ *Filename pattern*, saisissez votre pattern
+   — ex. : `[Category]_YYYY_MM_DD_titre`
+3. Cliquez **Save**
+4. Vérifiez la fenêtre *New Document* : le nom prévisualisé reflète le nouveau pattern
+
+⚠️ Le pattern doit contenir `[Category]` exactement une fois.
+```
+
+---
+
+### Quadrant 3 — Explication (*Concept*)
+
+**Question clé :** *"Pourquoi ça fonctionne ainsi ?"*
+
+Une explication **construit la compréhension**. Elle ne donne pas d'instructions mais éclaire les principes sous-jacents, les choix de conception, les compromis. Elle est lue hors contexte de travail, pour apprendre.
+
+**Caractéristiques :**
+- Analogies et schémas
+- Références croisées vers d'autres concepts
+- Aucune instruction à suivre
+- Répond au *pourquoi*, pas au *comment*
+
+**Exemple :**
+
+```
+## Pourquoi le nommage des fichiers détermine la structure
+
+Living Documentation ne s'appuie sur aucune base de données.
+La date, la catégorie et le titre sont encodés dans le nom du fichier,
+ce qui rend la documentation portable : un simple `cp -r` ou un
+dépôt Git suffit à la transférer. Le parser reconstruit la structure
+à la volée à chaque démarrage.
+
+Ce choix implique un compromis : renommer un fichier change son ID
+et invalide les deep links existants.
+```
+
+---
+
+### Quadrant 4 — Référence
+
+**Question clé :** *"Quelle est exactement la valeur de… ?"*
+
+Une référence est **consultée pendant le travail**, jamais lue de A à Z. Elle est exhaustive, structurée de façon uniforme, et mise à jour en même temps que le code.
+
+**Caractéristiques :**
+- Format tabulaire ou liste structurée
+- Exhaustif (tous les cas couverts)
+- Exemples pratiques inclus
+- Aucune narration ni explication
+
+**Exemple :**
+
+```
+## Tokens du pattern de nommage
+
+| Token       | Description                        | Exemple   |
+|-------------|------------------------------------|-----------|
+| `YYYY`      | Année sur 4 chiffres               | `2024`    |
+| `MM`        | Mois sur 2 chiffres                | `03`      |
+| `DD`        | Jour sur 2 chiffres                | `15`      |
+| `HH`        | Heure sur 2 chiffres (00–23)       | `14`      |
+| `mm`        | Minutes sur 2 chiffres             | `30`      |
+| `[Category]`| Nom de catégorie entre crochets    | `[Guide]` |
+| `title`     | Titre en snake_case                | `mon_doc` |
+```
+
+---
+
+### Appliquer Diátaxis dans Living Documentation
+
+Utilisez les **catégories** pour distinguer les types :
+
+| Catégorie suggérée | Quadrant Diátaxis |
+|--------------------|-------------------|
+| `[Tutoriel]`       | Tutoriel          |
+| `[Guide]`          | Guide pratique    |
+| `[Concept]`        | Explication       |
+| `[Reference]`      | Référence         |
+
+Organisez ensuite par **domaine fonctionnel** via les sous-dossiers :
+
+```
+docs/
+├── authentification/
+│   ├── 2024_01_10_[Tutoriel]_premiers_pas_auth.md
+│   ├── 2024_01_11_[Guide]_configurer_oauth.md
+│   ├── 2024_01_12_[Concept]_jwt_vs_sessions.md
+│   └── 2024_01_13_[Reference]_endpoints_auth.md
+└── facturation/
+    ├── 2024_02_01_[Tutoriel]_creer_premiere_facture.md
+    └── 2024_02_02_[Reference]_codes_erreur_paiement.md
+```
+
+> **Règle d'or** : si vous hésitez entre deux quadrants pour un document, c'est souvent le signe qu'il faut le diviser en deux documents distincts.
+
+---
+
+## Ressources
+
+- [Diátaxis — site officiel](https://diataxis.fr)
+- [Documentation chaotique ? Diátaxis à la rescousse](https://dev.to/onepoint/documentation-chaotique-diataxis-a-la-rescousse--3e9o)

package/dist/starting-doc/2_guide/2026_04_08_00_04_[DOCUMENT]_utilisation_des_images_plein_ecran_lien_clickable.md

@@ -0,0 +1,40 @@
+# En utilisant l'éditeur
+<details><summary>Cliquer pour voir les détails</summary>
+
+Si vous ne maitrisez pas le markdown, vous pouvez utiliser l'éditeur de document et insérer un **Snippet** de type :
+- lien
+- lien vers un document
+- lien vers une ancre
+- lien vers une ancre d'un autre document
+![image](./images/liens_snippets.png)
+</details>
+
+---
+
+# En codant
+<details><summary>Cliquer pour voir les détails</summary>
+
+Les images peuvent être intégrés dans vos documents de différentes façons mais au final les images sont représentées dans votre document par du code `markdown`
+
+Une image peut être **simple** ou **liée à une destination**
+
+- simple
+```markdown
+![Découvrons les ADRs](./images/decouverte_adrs.png)
+```
+
+- liée à un autre document de `living documentation`
+```
+[![Découvrons les ADRs](./images/decouverte_adrs.png)](?doc=3_concept%252F2026_04_08_20_58_%255BDOCUMENTING%255D_ADRS)
+```
+
+- liée à un **diagramme** de `living documentation`
+```
+[![The Living Documentation Tool](./images/living_documentation_tool.png)](/diagram?id=d1775684671412)
+```
+
+- liée à autre chose (généralement une page web)
+```
+[![NPM Package Living Documentation](npm_logo.png)](https://www.npmjs.com/package/living-documentation)
+```
+</details>

package/dist/starting-doc/2_guide/2026_04_08_23_38_[Configuration]_demarrage_de_living_documentation.md

@@ -0,0 +1,32 @@
+1 . Lancez l'outil en pointant vers votre dossier de documentation, le mieux étant de versionner ce dossier au sein de votre projet :
+
+```bash
+npx living-documentation ./docs
+```
+
+Le serveur démarre sur le port **4321** par défaut. Ouvrez [http://localhost:4321](http://localhost:4321) dans votre navigateur.
+
+---
+
+### Options disponibles
+
+Pour connaitre toutes les options disponibles faites
+```bash
+npx living-documentation -h
+```
+
+```
+Usage: living-documentation [options] [folder]
+
+Serve a local Markdown documentation viewer
+
+Arguments:
+  folder               Path to documentation folder (default: ".")
+
+Options:
+  -V, --version        output the version number
+  -i, --init           Initialize a demo project
+  -p, --port <number>  Port to listen on (default: "4321")
+  -o, --open           Open browser automatically
+  -h, --help           display help for command
+```

package/dist/starting-doc/2_guide/2026_04_09_09_00_[NAVIGATION]_recherche_plein_texte.md

@@ -0,0 +1,65 @@
+## Recherche plein texte
+
+Living Documentation propose deux niveaux de recherche accessibles depuis le champ en haut de la barre latérale.
+
+---
+
+### Filtre instantané (client-side)
+
+Dès que vous tapez dans le champ de recherche, la liste des documents est filtrée **en temps réel** sur le titre et la catégorie.
+
+- Aucun délai, aucun rechargement
+- Utile pour retrouver rapidement un document dont vous connaissez le nom
+
+---
+
+### Recherche plein texte (server-side)
+
+Après **350 ms** sans frappe, une recherche côté serveur est déclenchée automatiquement. Elle parcourt le contenu complet de tous les fichiers `.md`.
+
+**Résultats :**
+
+- Chaque fichier correspondant est listé
+- Pour chaque fichier, **toutes les occurrences** sont affichées avec leur contexte
+- Les occurrences sont **surlignées** dans la liste
+- Cliquer sur une occurrence ouvre le document **et défile jusqu'à la section concernée**
+
+---
+
+### Cas d'usage
+
+| Vous cherchez…                          | Approche recommandée          |
+|-----------------------------------------|-------------------------------|
+| Un document dont vous connaissez le nom | Filtre instantané (taper le titre) |
+| Un concept mentionné dans n'importe quel doc | Recherche plein texte (attendre 350 ms) |
+| Toutes les occurrences d'un terme       | Recherche plein texte         |
+
+---
+
+### Deep links
+
+Chaque document possède une **URL stable** de la forme :
+
+```
+http://localhost:4321/?doc=<id_encodé>
+```
+
+Vous pouvez **copier cette URL** depuis la barre d'adresse du navigateur et la partager, la mettre en favori, ou l'utiliser dans un lien Markdown inter-documents :
+
+```markdown
+[Voir la référence API](?doc=4_reference%252F2026_04_09_02_00_%255BREFERENCE%255D_tokens_pattern_nommage)
+```
+
+> L'ID est stable tant que le nom du fichier ne change pas. Renommer un fichier invalide les liens existants.
+
+---
+
+### Navigation par ancres
+
+Les titres `##`, `###`, etc. génèrent automatiquement des **ancres navigables**. Vous pouvez créer un lien vers une section précise :
+
+```markdown
+[Voir la section Résultats](#résultats)
+```
+
+Le scroll est déclenché après le rendu asynchrone du document — le lien fonctionne même si la page vient d'être ouverte.

package/dist/starting-doc/2_guide/2026_04_09_10_00_[EXPORT]_exporter_en_pdf.md

@@ -0,0 +1,43 @@
+## Exporter un document en PDF
+
+Living Documentation propose deux modes d'export PDF, accessibles sans configuration particulière.
+
+---
+
+### Export du document courant
+
+1. Ouvrez le document à exporter.
+2. Cliquez sur le bouton **`📄 PDF`** dans le header de l'article.
+3. La boîte de dialogue d'impression du navigateur s'ouvre.
+4. Choisissez **Enregistrer en PDF** comme imprimante.
+
+**Ce qui est inclus :**
+
+- Le contenu de l'article (rendu HTML complet)
+- Les blocs de code avec coloration syntaxique
+
+**Ce qui est masqué à l'impression :**
+
+- La barre latérale
+- Le header de navigation
+- Les boutons d'action (Edit, PDF, etc.)
+
+> Le CSS `@media print` est configuré pour produire un rendu propre sans éléments d'interface.
+
+---
+
+### Export de tous les documents (PDF complet)
+
+1. Cliquez sur le bouton **`📄 PDF`** en haut de la **barre latérale** (pas dans l'article).
+2. Un PDF complet est généré avec :
+   - Une **table des matières** cliquable en début de document
+   - Tous les documents dans l'ordre de la sidebar
+   - Les **liens inter-documents** restent fonctionnels dans le PDF
+
+---
+
+### Conseils pour un meilleur rendu
+
+- Utilisez **Chrome** ou **Edge** pour la meilleure qualité d'export PDF (le moteur de rendu produit des résultats plus fidèles que Safari ou Firefox)
+- Dans la boîte de dialogue d'impression, activez **"Graphiques d'arrière-plan"** pour conserver les couleurs des blocs de code et des badges
+- Format recommandé : **A4**, marges normales