@hgdc/docs 0.4.2 → 0.4.4

package/template/.build/reference/cli.md

@@ -1,167 +1,31 @@
-# CLI
+# La commande hgdc-docs
 
-Host accepte la CLI Vercel officielle, version 63. Cette page décrit les commandes prises en charge, leurs options et ce qui n’est pas encore pris en charge.
+`hgdc-docs` est installée avec le paquet `@hgdc/docs`. Elle se lance depuis le dossier de la doc, ou avec le chemin du dossier en argument.
 
-## Configurer la CLI
+## Commandes
 
-Host n’utilise pas la connexion par navigateur de la CLI. Chaque commande reçoit l’adresse de l’API par `--api` et la clé par la variable `VERCEL_TOKEN`.
+| Commande            | Effet                                                                                                      |
+| ------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `hgdc-docs dev`     | Site local sur `http://localhost:4321`, rechargé à chaque modification.                                    |
+| `hgdc-docs build`   | Site statique dans `dist/`, avec la recherche, `llms.txt`, les pages Markdown et le corpus de l’assistant. |
+| `hgdc-docs preview` | Sert le dernier build, pour vérifier avant de pousser.                                                     |
 
-```bash
-npm install --global vercel@63
-export VERCEL_TOKEN=ah_…
-vercel --api https://api.host.hgdc.ch deploy
-```
+Options : `--port 4000` change le port de `dev` et `preview`, `--help` affiche l’aide.
 
-Pour ne pas retaper l’adresse, crée un alias dans ton profil de shell :
+## Variables d’environnement
 
-```bash
-# ~/.bashrc ou ~/.zshrc
-alias vh="vercel --api https://api.host.hgdc.ch"
+| Variable         | Rôle                                                                                                                                                                |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `HGDC_DOCS_SITE` | Adresse publique du site (`https://docs.acme.ch`). Rend les liens de `llms.txt` absolus et produit le sitemap. Sur Host, l’adresse de production est reprise seule. |
+| `HGDC_DOCS_OUT`  | Dossier de sortie, `dist/` par défaut.                                                                                                                              |
+| `HGDC_DOCS_API`  | API de l’assistant, `https://docs.hgdc.ch` par défaut.                                                                                                              |
 
-# Ensuite
-vh deploy --prod
-```
+## Ce que contient dist/
 
-En PowerShell, dans `$PROFILE` :
-
-```powershell
-function vh { vercel --api https://api.host.hgdc.ch @args }
-```
-
-> **Attention**
->
-> Sans `--api`, la CLI parle à Vercel. Si une commande te demande de te connecter dans le navigateur, vérifie que l’option est bien présente.
-
-### Options globales
-
-| Option    | Valeur | Rôle                                                                                         |
-| --------- | ------ | -------------------------------------------------------------------------------------------- |
-| `--api`   | URL    | Adresse de l’API : `https://api.host.hgdc.ch`                                                |
-| `--token` | `ah_…` | Clé d’API. Préfère la variable `VERCEL_TOKEN`, qui n’apparaît pas dans l’historique du shell |
-
-### Ce qui n’est pas pris en charge
-
-| Commande ou option  | État                                                                                         |
-| ------------------- | -------------------------------------------------------------------------------------------- |
-| `vercel login`      | Non : la connexion passe par la clé                                                          |
-| `vercel env`        | Pas encore : gère les variables dans la console                                              |
-| `vercel domains`    | Pas encore : gère les domaines dans la console                                               |
-| `vercel logs`       | Pas encore : les logs sont dans la console                                                   |
-| `vercel alias`      | Pas encore : utilise la console, voir [Revenir en arrière](/docs/guides/revenir-en-arriere/) |
-| `--scope`, `--team` | Ignorés : l’organisation vient de la clé                                                     |
-
-## vercel deploy
-
-Envoie un dossier, ou un build déjà construit, et crée un déploiement. Sans option, la commande crée une preview. Avec `--prod`, elle part en production.
-
-```bash
-# Preview du dossier courant
-vercel --api https://api.host.hgdc.ch deploy
-
-# Production
-vercel --api https://api.host.hgdc.ch deploy --prod
-```
-
-Dans un script, l’adresse du déploiement est écrite seule sur la sortie standard :
-
-```bash
-URL=$(vercel --api https://api.host.hgdc.ch deploy --yes)
-echo "Preview : $URL"
-```
-
-| Option                | Rôle                                                                                        |
-| --------------------- | ------------------------------------------------------------------------------------------- |
-| `--prod`              | Déploie en production                                                                       |
-| `--prebuilt`          | Envoie `.vercel/output`, produit par `vercel build`, sans reconstruire                      |
-| `--yes`               | Répond oui à toutes les questions : relie le dossier et crée le projet. Indispensable en CI |
-| `--cwd <chemin>`      | Dossier à déployer, s’il n’est pas le dossier courant                                       |
-| `--meta <clé=valeur>` | Métadonnée attachée au déploiement                                                          |
-
-La commande affiche l’adresse du déploiement, suit la publication, puis rend la main quand le déploiement est prêt ou en erreur. Le suivi dure 9 minutes au plus.
-
-Pour un framework, construis d’abord avec `vercel build`, puis envoie le résultat avec `--prebuilt`. Utilise la même cible des deux côtés : `build --prod` avec `deploy --prebuilt --prod`, ou aucune des deux pour une preview. Sinon, la CLI refuse l’envoi.
-
-## vercel build
-
-Construit le projet en local ou en CI, au format Build Output API. Le résultat va dans `.vercel/output`, prêt pour `vercel deploy --prebuilt`.
-
-```bash
-# Build de preview
-vercel --api https://api.host.hgdc.ch build
-
-# Build de production
-vercel --api https://api.host.hgdc.ch build --prod
-```
-
-Avant de construire, la commande télécharge les variables de l’environnement visé : preview par défaut, production avec `--prod`. Une variable sensible n’est pas téléchargée depuis un poste, seulement depuis le build du dépôt GitHub.
-
-| Option           | Rôle                                                                      |
-| ---------------- | ------------------------------------------------------------------------- |
-| `--prod`         | Construit pour la production, avec les variables de production            |
-| `--yes`          | Télécharge les réglages du projet sans rien demander. Indispensable en CI |
-| `--cwd <chemin>` | Dossier du projet, s’il n’est pas le dossier courant                      |
-
-## vercel pull
-
-Télécharge les réglages du projet et les variables d’un environnement. `vercel build` s’en sert ensuite.
-
-```bash
-# Variables de développement, par défaut
-vercel --api https://api.host.hgdc.ch pull
-
-# Variables de preview ou de production
-vercel --api https://api.host.hgdc.ch pull --environment=preview
-vercel --api https://api.host.hgdc.ch pull --environment=production
-```
-
-Les variables sont écrites dans `.vercel/.env.<environnement>.local`. La CLI ajoute ce dossier au `.gitignore` : ne le commite pas.
-
-| Option           | Valeur                                   | Rôle                                                 |
-| ---------------- | ---------------------------------------- | ---------------------------------------------------- |
-| `--environment`  | `development`, `preview` ou `production` | Environnement à lire. Par défaut : `development`     |
-| `--yes`          |                                          | Relie le dossier sans rien demander                  |
-| `--cwd <chemin>` |                                          | Dossier du projet, s’il n’est pas le dossier courant |
-
-Ce que reçoit la commande dépend de la clé :
-
-| Clé                                   | Variables normales | Variables sensibles |
-| ------------------------------------- | ------------------ | ------------------- |
-| Clé d’organisation                    | Oui                | Non                 |
-| Clé de projet, posée par l’app GitHub | Oui                | Oui                 |
-
-## vercel link
-
-Relie un dossier local à un projet. Les autres commandes savent ensuite à quel projet s’adresser.
-
-```bash
-vercel --api https://api.host.hgdc.ch link
-
-# Sans question, avec le nom du dossier
-vercel --api https://api.host.hgdc.ch link --yes
-```
-
-La liaison est écrite dans `.vercel/project.json`, qui contient `orgId` et `projectId`. Le premier `link` ou `deploy` sur un nom inconnu crée le projet, sous le nom du dossier.
-
-| Option            | Rôle                                                                     |
-| ----------------- | ------------------------------------------------------------------------ |
-| `--yes`           | Relie le dossier sans rien demander, et crée le projet s’il n’existe pas |
-| `--project <nom>` | Nom du projet à relier, s’il n’est pas celui du dossier                  |
-| `--cwd <chemin>`  | Dossier à relier, s’il n’est pas le dossier courant                      |
-
-En CI, sans dossier `.vercel`, donne les deux identifiants par variables d’environnement, avec la clé :
-
-```bash
-export VERCEL_ORG_ID=…
-export VERCEL_PROJECT_ID=…
-export VERCEL_TOKEN=ah_…
-vercel --api https://api.host.hgdc.ch deploy --prod --yes
-```
-
-`VERCEL_ORG_ID` est la valeur renvoyée par [GET /v2/user](/docs/reference/api/utilisateur/). Le workflow posé par l’app GitHub contient déjà les bonnes valeurs.
-
-Pour délier un dossier, supprime son dossier `.vercel`. Le prochain déploiement te redemandera le projet.
-
-## Voir aussi
-
-- [Référence de l’API](/docs/reference/api/introduction/) : les mêmes opérations, sans la CLI.
-- [Compatibilité](/docs/reference/compatibilite/) : la liste des fonctions de la CLI et de la plateforme.
+| Fichier                                             | Contenu                                                        |
+| --------------------------------------------------- | -------------------------------------------------------------- |
+| `index.html`, `<page>/index.html`                   | Les pages du site.                                             |
+| `<page>.md`                                         | Chaque page en Markdown.                                       |
+| `llms.txt`, `llms-full.txt`, `.well-known/llms.txt` | L’index et la doc complète pour les agents.                    |
+| `pagefind/`                                         | L’index de la recherche.                                       |
+| `_hgdc/corpus.json`                                 | Le contenu publié, lu par la console pour indexer l’assistant. |

package/template/.build/reference/docs-json/index.html

@@ -0,0 +1,157 @@
+<!DOCTYPE html><html lang="fr-CH" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-wgg3zgff"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"/><title>docs.json | Docs</title><style>:root{--sl-color-accent-low:#282041;--sl-color-accent:#aa73ff;--sl-color-accent-high:#e8b7ff;--hgdc-on-accent:#000000;}:root:not([data-hd-theme="dark"]){--sl-color-accent-low:#f1e9ff;--sl-color-accent:#7c3aed;--sl-color-accent-high:#4e00ae;--hgdc-on-accent:#ffffff;}</style><link rel="shortcut icon" href="/images/favicon.svg" type="image/svg+xml"/><meta name="generator" content="Astro v7.3.8"/><meta name="generator" content="Starlight v0.42.6"/><meta property="og:title" content="docs.json"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Tous les champs du fichier de configuration d'un site Docs."/><meta property="og:site_name" content="Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Tous les champs du fichier de configuration d'un site Docs."/><link rel="alternate" type="text/markdown" href="/reference/docs-json.md"><link rel="describedby" type="text/markdown" href="/llms.txt"><script>
+  ;(() => {
+    let stored = null
+    try {
+      stored = localStorage.getItem("starlight-theme")
+    } catch {}
+    const dark =
+      stored === "dark" || (stored === "auto" && matchMedia("(prefers-color-scheme: dark)").matches)
+    const theme = dark ? "dark" : "light"
+    document.documentElement.dataset.theme = theme
+    document.documentElement.dataset.hdTheme = theme
+    window.StarlightThemeProvider = { updatePickers() {} }
+  })()
+</script><link rel="stylesheet" href="/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/_astro/common.Ixp7olnv.css"><style>@layer starlight.components{svg:where(.astro-5loz3ns4){color:var(--sl-icon-color);font-size:var(--sl-icon-size,1em);width:1em;height:1em;overflow:visible}}
+@layer starlight.components{starlight-tabs:where(.astro-fmorvire){display:block}.tablist-wrapper:where(.astro-fmorvire){overflow-x:auto}:where(.astro-fmorvire)[role=tablist]{border-bottom:2px solid var(--sl-color-gray-5);padding:0;list-style:none;display:flex}.tab:where(.astro-fmorvire){display:flex}.tab:where(.astro-fmorvire)>:where(.astro-fmorvire)[role=tab]{--sl-tab-color-border:var(--sl-color-gray-5);line-height:var(--sl-line-height-headings);box-shadow:0 2px 0 var(--sl-tab-color-border);color:var(--sl-color-gray-3);outline-offset:var(--sl-outline-offset-inside);overflow-wrap:initial;align-items:center;gap:.5rem;padding:.275rem 1.25rem;text-decoration:none;display:flex}.tab:where(.astro-fmorvire) :where(.astro-fmorvire)[role=tab][aria-selected=true]{--sl-tab-color-border:var(--sl-color-text-accent);color:var(--sl-color-white);font-weight:600}.tablist-wrapper:where(.astro-fmorvire)~[role=tabpanel]{margin-top:1rem}}
+</style><script type="module" src="/_astro/page.cNngjUgL.js"></script></head><body class="astro-wgg3zgff"><a class="sl-skip-link astro-mdf5cdqa" href="#_top">Aller au contenu</a><div class="hd-page"><header class="hd-topbar"><div class="hd-header"><div class="hd-header__start"><button type="button" class="hd-icon-button hd-menu-button" popovertarget="starlight__sidebar" aria-label="Menu de la documentation" aria-controls="starlight__sidebar"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 7h16M4 12h16M4 17h10"></path></svg></button><a class="hd-brand" href="/"><span class="hd-brand__mark"><img class="hd-brand__light" src="/images/logo-clair.svg" alt="" width="24" height="24"><img class="hd-brand__dark" src="/images/logo-sombre.svg" alt="" width="24" height="24"></span><span class="hd-brand__name">Docs</span></a></div><nav class="hd-header__tabs" aria-label="Sections de la documentation"><a href="/">Guides</a><a href="/reference/docs-json/" aria-current="page">Référence</a><a href="/explications/fonctionnement/">Explications</a></nav><div class="hd-header__end"><hd-search data-base data-assistant><button type="button" class="hd-search-trigger" data-open aria-haspopup="dialog" aria-label="Rechercher (Ctrl K)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M11 18a7 7 0 1 0 0-14 7 7 0 0 0 0 14Zm5-2 4 4"></path></svg><span class="hd-search-trigger__label">Rechercher</span><kbd class="hd-kbd" data-shortcut>Ctrl K</kbd></button><dialog class="hd-palette" aria-label="Rechercher dans la documentation"><div class="hd-palette__box"><div class="hd-palette__field"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M11 18a7 7 0 1 0 0-14 7 7 0 0 0 0 14Zm5-2 4 4"></path></svg><input type="text" data-input placeholder="Rechercher dans la documentation" autocomplete="off" spellcheck="false" role="combobox" aria-expanded="false" aria-controls="hd-palette-results" aria-autocomplete="list"><button type="button" class="hd-kbd hd-kbd--button" data-close>Échap</button></div><div class="hd-palette__results" id="hd-palette-results" role="listbox" aria-label="Résultats" data-results></div><p class="hd-palette__status" data-status role="status">Tape un mot pour chercher dans les pages.</p><footer class="hd-palette__hints" aria-hidden="true"><span><kbd class="hd-kbd">↑</kbd><kbd class="hd-kbd">↓</kbd> Choisir</span><span><kbd class="hd-kbd">↵</kbd> Ouvrir</span><span><kbd class="hd-kbd">Échap</kbd> Fermer</span></footer></div></dialog></hd-search><script type="module" src="/_astro/Search.astro_astro_type_script_index_0_lang.VKDD8r2I.js"></script><button type="button" class="hd-icon-button" data-hgdc-ask aria-label="Demander à l'assistant" title="Demander à l'assistant (Ctrl I)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3.5 13.6 8a3 3 0 0 0 1.9 1.9L20 11.5l-4.5 1.6a3 3 0 0 0-1.9 1.9L12 19.5 10.4 15a3 3 0 0 0-1.9-1.9L4 11.5 8.5 9.9A3 3 0 0 0 10.4 8ZM19 3v3M20.5 4.5h-3"></path></svg></button><nav class="hd-header__links" aria-label="Liens"><a class="hd-pill hd-pill--ghost" href="https://hgdc.ch">HGDC</a><a class="hd-pill hd-pill--primary" href="https://docs.hgdc.ch">Console</a></nav><button type="button" class="hd-icon-button hd-theme-button" data-hd-theme-toggle aria-label="Passer au thème sombre"><svg class="hd-icon hd-theme-button__moon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg><svg class="hd-icon hd-theme-button__sun" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><script type="module">var e=`starlight-theme`,t=()=>{try{return localStorage.getItem(e)||`light`}catch{return`light`}},n=()=>matchMedia(`(prefers-color-scheme: light)`).matches?`light`:`dark`,r=t=>{try{localStorage.setItem(e,t)}catch{}let r=t===`auto`?n():t;document.documentElement.dataset.theme=r,document.documentElement.dataset.hdTheme=r,i()},i=()=>{let e=t(),n=document.documentElement.dataset.theme===`dark`;for(let e of document.querySelectorAll(`[data-hd-theme-toggle]`))e.setAttribute(`aria-label`,n?`Passer au thème clair`:`Passer au thème sombre`);for(let t of document.querySelectorAll(`[data-hd-theme-choice]`)){let n=t.dataset.hdThemeChoice===e;t.setAttribute(`aria-checked`,String(n)),t.tabIndex=n?0:-1}};for(let e of document.querySelectorAll(`[data-hd-theme-toggle]`))e.addEventListener(`click`,()=>r(document.documentElement.dataset.theme===`dark`?`light`:`dark`));for(let e of document.querySelectorAll(`.hd-theme-choice`)){let t=[...e.querySelectorAll(`[data-hd-theme-choice]`)];for(let e of t)e.addEventListener(`click`,()=>r(e.dataset.hdThemeChoice));e.addEventListener(`keydown`,e=>{let n=e.key===`ArrowRight`||e.key===`ArrowDown`?1:e.key===`ArrowLeft`||e.key===`ArrowUp`?-1:0;if(!n)return;e.preventDefault();let i=t.findIndex(e=>e.getAttribute(`aria-checked`)===`true`),a=t[(i+n+t.length)%t.length];r(a.dataset.hdThemeChoice),a.focus()})}matchMedia(`(prefers-color-scheme: light)`).addEventListener(`change`,()=>{t()===`auto`&&r(`auto`)}),i();</script></div></div></header><nav class="hd-sidebar" aria-label="Navigation de la documentation"><script type="module">for(let e of document.querySelectorAll(`[data-hgdc-version]`))e.addEventListener(`change`,()=>window.location.assign(e.value));var e=document.querySelector(`.sidebar-pane`);if(e){let t=`hd-sidebar-scroll`;try{let n=Number(sessionStorage.getItem(t));n&&(e.scrollTop=n)}catch{}let n=e.querySelector(`[aria-current="page"]`);if(n){let t=e.getBoundingClientRect(),r=n.getBoundingClientRect();(r.top<t.top||r.bottom>t.bottom)&&n.scrollIntoView({block:`center`})}addEventListener(`pagehide`,()=>{try{sessionStorage.setItem(t,String(e.scrollTop))}catch{}})}</script><hd-sidebar-pane popover="auto" id="starlight__sidebar" class="sidebar-pane"><div class="hd-sidebar__content"><div class="hd-mobile-only hd-sidebar-head"><a class="hd-brand" href="/"><span class="hd-brand__name">Docs</span></a><button type="button" class="hd-icon-button" popovertarget="starlight__sidebar" popovertargetaction="hide" aria-label="Fermer le menu"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M6 6l12 12M18 6 6 18"></path></svg></button></div><nav class="hd-mobile-only hd-sidebar-tabs" aria-label="Sections de la documentation"><a href="/">Guides</a><a href="/reference/docs-json/" aria-current="page">Référence</a><a href="/explications/fonctionnement/">Explications</a></nav><ul class="hd-nav hd-nav--depth-0"><li class="hd-nav__group"><p class="hd-nav__heading">Configuration</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/reference/docs-json/" class="hd-nav__link" aria-current="page"><span>docs.json</span></a></li><li><a href="/reference/cli/" class="hd-nav__link"><span>Commande hgdc-docs</span></a></li></ul></li><li class="hd-nav__group"><p class="hd-nav__heading">API</p><ul class="hd-nav hd-nav--depth-1"><li><a href="/reference/api-assistant/" class="hd-nav__link"><span>API de l&#39;assistant</span></a></li><li><a href="/reference/mcp/" class="hd-nav__link"><span>Serveur MCP</span></a></li></ul></li></ul><div class="hd-mobile-only hd-sidebar-footer"><nav class="hd-sidebar-links" aria-label="Liens"><a href="https://hgdc.ch">HGDC</a><a class="hd-pill hd-pill--primary" href="https://docs.hgdc.ch">Console</a></nav><div class="hd-theme-choice" role="radiogroup" aria-label="Thème"><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="auto" aria-label="Système" title="Système"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1Zm4 15h8m-4-3v3"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="light" aria-label="Clair" title="Clair"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="dark" aria-label="Sombre" title="Sombre"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg></button></div></div></div></hd-sidebar-pane></nav><div class="hd-main-frame main-frame"><script type="module">var e=document.getElementById(`starlight__sidebar`),t=e?.querySelector(`sl-sidebar-state-persist`),n=`sl-sidebar-state`,r=()=>{let r=[],i=t?.dataset.hash||``;try{let e=sessionStorage.getItem(n),t=JSON.parse(e||`{}`);Array.isArray(t.open)&&t.hash===i&&(r=t.open)}catch{}return{hash:i,open:r,scroll:e?.scrollTop||0}},i=e=>{try{sessionStorage.setItem(n,JSON.stringify(e))}catch{}},a=()=>i(r()),o=(e,t)=>{let n=r();n.open[t]=e,i(n)};t?.addEventListener(`click`,e=>{if(!(e.target instanceof Element))return;let t=e.target.closest(`summary`)?.closest(`details`);if(!t)return;let n=t.querySelector(`sl-sidebar-restore`),r=parseInt(n?.dataset.index||``);isNaN(r)||o(!t.open,r)}),addEventListener(`visibilitychange`,()=>{document.visibilityState===`hidden`&&a()});</script><div class="hd-columns hd-columns--toc"><div class="hd-columns__main main-pane"><main data-pagefind-body class="astro-wgg3zgff" lang="fr-CH" dir="ltr"><div class="content-panel astro-5uqqnepj"><div class="sl-container astro-5uqqnepj"><div class="hd-title not-content"><p class="hd-eyebrow" data-pagefind-meta="section">Configuration</p><div class="hd-title__row"><h1 id="_top">docs.json</h1><div class="hd-page-actions" data-hgdc-skip data-pagefind-ignore><div class="hd-split"><button type="button" class="hd-split__main" data-hgdc-copy="/reference/docs-json.md"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M9 9h10a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V10a1 1 0 0 1 1-1Zm-4 6H4.5A1.5 1.5 0 0 1 3 13.5v-9A1.5 1.5 0 0 1 4.5 3h9A1.5 1.5 0 0 1 15 4.5V5"></path></svg><span data-label>Copier la page</span></button><details class="hd-menu"><summary class="hd-split__more" aria-label="Autres formats de la page"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m6 9 6 6 6-6"></path></svg></summary><ul class="hd-menu__list"><li><button type="button" data-hgdc-copy-item><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M9 9h10a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V10a1 1 0 0 1 1-1Zm-4 6H4.5A1.5 1.5 0 0 1 3 13.5v-9A1.5 1.5 0 0 1 4.5 3h9A1.5 1.5 0 0 1 15 4.5V5"></path></svg><span><strong>Copier la page</strong><small>En Markdown, pour un LLM</small></span></button></li><li><a href="/reference/docs-json.md"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 6h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V7a1 1 0 0 1 1-1Zm3 9V9l2.5 3L12 9v6m5-6v6m-2-2 2 2 2-2"></path></svg><span><strong>Voir en Markdown</strong><small>La page en texte brut</small></span></a></li><li><a data-hgdc-open="claude" href="https://claude.ai/new" target="_blank" rel="noopener"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 17 17 7M8 7h9v9"></path></svg><span><strong>Ouvrir dans Claude</strong><small>Poser une question sur cette page</small></span></a></li><li><a data-hgdc-open="chatgpt" href="https://chatgpt.com/" target="_blank" rel="noopener"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 17 17 7M8 7h9v9"></path></svg><span><strong>Ouvrir dans ChatGPT</strong><small>Poser une question sur cette page</small></span></a></li><li><a href="/llms.txt"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8Zm0 0v5h5M9 13h6m-6 4h4"></path></svg><span><strong>llms.txt</strong><small>L'index de la doc pour les agents</small></span></a></li></ul></details></div><span class="sr-only" role="status" aria-live="polite" data-hgdc-copy-status></span></div></div><p class="hd-lead">Tous les champs du fichier de configuration d&#39;un site Docs.</p></div><script type="module">var e=document.querySelector(`[data-hgdc-copy-status]`),t=document.querySelector(`[data-hgdc-copy]`);async function n(){if(!t)return;let n=t.querySelector(`[data-label]`),r=t=>{n.textContent=t,e&&(e.textContent=t),setTimeout(()=>n.textContent=`Copier la page`,2e3)};try{let e=await fetch(t.dataset.hgdcCopy);if(!e.ok)throw Error(String(e.status));await navigator.clipboard.writeText(await e.text()),r(`Page copiée`)}catch{r(`Copie impossible`)}}if(t?.addEventListener(`click`,()=>void n()),document.querySelector(`[data-hgdc-copy-item]`)?.addEventListener(`click`,()=>{document.querySelector(`.hd-menu`).open=!1,n()}),t){let e=`Lis ${new URL(t.dataset.hgdcCopy,location.href).href} et réponds à mes questions sur cette page.`;for(let t of document.querySelectorAll(`[data-hgdc-open]`))t.href=`${t.dataset.hgdcOpen===`claude`?`https://claude.ai/new`:`https://chatgpt.com/`}?q=${encodeURIComponent(e)}`}for(let e of document.querySelectorAll(`.hd-menu`))document.addEventListener(`click`,t=>{e.open&&!e.contains(t.target)&&(e.open=!1)}),e.addEventListener(`keydown`,t=>{t.key===`Escape`&&e.open&&(t.stopPropagation(),e.open=!1,e.querySelector(`summary`)?.focus())});</script></div></div><div class="content-panel astro-5uqqnepj"><div class="sl-container astro-5uqqnepj"><div class="sl-markdown-content"><p><code>docs.json</code> vit à la racine du dossier de la doc. Il reprend le format de Mintlify : les champs que Docs ne gère pas sont acceptés et ignorés. Pour l’autocomplétion dans ton éditeur, ajoute <code>"$schema": "https://docs.hgdc.ch/docs.schema.json"</code>.</p>
+<h2 id="champs">Champs</h2>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="hd-table"><table><thead><tr><th>Champ</th><th>Type</th><th>Obligatoire</th><th>Rôle</th></tr></thead><tbody><tr><td><code>name</code></td><td>texte</td><td>oui</td><td>Nom de la doc, en tête du site et dans <code>llms.txt</code>. 80 caractères au plus.</td></tr><tr><td><code>description</code></td><td>texte</td><td>non</td><td>Une phrase de présentation.</td></tr><tr><td><code>navigation</code></td><td>objet</td><td>oui</td><td>Pages, groupes, onglets ou versions. Voir <a href="/guides/navigation/">Navigation</a>.</td></tr><tr><td><code>project</code></td><td>texte</td><td>non</td><td>Identifiant du projet dans la console. Active l’assistant et l’indexation.</td></tr><tr><td><code>language</code></td><td><code>fr</code>, <code>en</code>, <code>de</code>, <code>it</code></td><td>non</td><td>Langue de l’interface du site. <code>fr</code> par défaut.</td></tr><tr><td><code>base</code></td><td>texte</td><td>non</td><td>Sous-chemin où la doc est servie, par exemple <code>/docs</code> quand ton application la publie derrière un proxy (<code>https://app.acme.ch/docs</code>). Liens, images, recherche, <code>llms.txt</code> et pages <code>.md</code> le portent ; le site est écrit dans <code>dist/docs/</code>. Écris tes liens depuis la racine de la doc (<code>/guides/publier/</code>) : le sous-chemin est ajouté au build.</td></tr><tr><td><code>colors.primary</code></td><td>couleur <code>#rrggbb</code></td><td>non</td><td>Couleur des liens et des éléments actifs.</td></tr><tr><td><code>colors.dark</code></td><td>couleur <code>#rrggbb</code></td><td>non</td><td>La même, en mode sombre.</td></tr><tr><td><code>logo</code></td><td>chemin, ou <code>{ light, dark }</code></td><td>non</td><td>Logo affiché en tête.</td></tr><tr><td><code>favicon</code></td><td>chemin</td><td>non</td><td>Icône de l’onglet du navigateur.</td></tr><tr><td><code>navbar.links</code></td><td>liste de <code>{ label, href }</code></td><td>non</td><td>Jusqu’à 5 liens dans la barre du haut (adresses complètes).</td></tr><tr><td><code>navbar.primary</code></td><td><code>{ label, href }</code></td><td>non</td><td>Bouton mis en avant à droite de la barre du haut.</td></tr><tr><td><code>footer.socials</code></td><td>objet</td><td>non</td><td>Liens vers tes réseaux : <code>linkedin</code>, <code>github</code>, <code>gitlab</code>, <code>x</code>, <code>youtube</code>, <code>instagram</code>, <code>facebook</code>, <code>discord</code>, <code>mastodon</code>, <code>bluesky</code>, <code>website</code>.</td></tr><tr><td><code>redirects</code></td><td>liste de <code>{ source, destination, permanent }</code></td><td>non</td><td>Anciennes adresses qui mènent aux nouvelles. <code>source</code> est un chemin du site (<code>/guides/ancien</code>), <code>destination</code> un chemin ou une adresse <code>https://</code>. <code>permanent: false</code> pour une redirection temporaire. 500 au plus.</td></tr><tr><td><code>assistant.enabled</code></td><td>oui / non</td><td>non</td><td><code>false</code> cache l’assistant du site.</td></tr><tr><td><code>assistant.endpoint</code></td><td>adresse</td><td>non</td><td>API de l’assistant, à ne changer que pour un environnement de test.</td></tr></tbody></table></div>
+<h2 id="navigation">Navigation</h2>
+<p>Quatre formes, une seule à la fois :</p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="hd-table"><table><thead><tr><th>Forme</th><th>Exemple</th></tr></thead><tbody><tr><td><code>pages</code></td><td><code>["index", "installation"]</code></td></tr><tr><td><code>groups</code></td><td><code>[{ "group": "Démarrer", "pages": ["index"] }]</code></td></tr><tr><td><code>tabs</code></td><td><code>[{ "tab": "Guides", "groups": [...] }]</code></td></tr><tr><td><code>versions</code></td><td><code>[{ "version": "v2", "default": true, "groups": [...] }]</code></td></tr></tbody></table></div>
+<p>Un groupe accepte <code>expanded: false</code> pour être replié par défaut, et peut contenir des groupes.</p>
+<h2 id="erreurs">Erreurs</h2>
+<p>Un <code>docs.json</code> invalide fait échouer le build avec la liste des problèmes, par exemple :</p>
+<div class="expressive-code"><link rel="stylesheet" href="/_astro/ec.t9qpe.css"><script type="module" src="/_astro/ec.0vx5m.js"></script><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="text"><code><div class="ec-line"><div class="code"><span style="--0:#1f2328;--1:#e6edf3">docs.json invalide :</span></div></div><div class="ec-line"><div class="code"><span style="--0:#1f2328;--1:#e6edf3">- colors.primary : couleur attendue au format #rrggbb</span></div></div><div class="ec-line"><div class="code"><span style="--0:#1f2328;--1:#e6edf3">- navigation : utiliser une seule forme parmi versions, tabs, groups ou pages</span></div></div></code></pre><div class="copy"><div aria-live="polite"></div><button title="Copier dans le presse-papiers" data-copied="Copié !" data-code="docs.json invalide :- colors.primary : couleur attendue au format #rrggbb- navigation : utiliser une seule forme parmi versions, tabs, groups ou pages"><div></div></button></div></figure></div></div><hgdc-feedback class="hgdc-feedback not-content" data-endpoint="https://docs.hgdc.ch/api/v1/feedback" data-project="jn7dj6vzkgs7n2d16kqjtb99yd8gbdw0" data-pagefind-ignore="true"><div data-step="ask"><p class="hgdc-feedback__question">Cette page t'a aidé ?</p><div class="hgdc-feedback__choices"><button type="button" data-helpful="true"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M7 10v11M15 5.9 14 10h5.8a2 2 0 0 1 1.9 2.5l-2.3 7A2 2 0 0 1 17.5 21H4a1 1 0 0 1-1-1v-9a1 1 0 0 1 1-1h2.8a2 2 0 0 0 1.8-1.1L12 2a3.1 3.1 0 0 1 3 3.9Z"></path></svg>Oui</button><button type="button" data-helpful="false"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M17 14V3M9 18.1 10 14H4.2a2 2 0 0 1-1.9-2.5l2.3-7A2 2 0 0 1 6.5 3H20a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1h-2.8a2 2 0 0 0-1.8 1.1L12 22a3.1 3.1 0 0 1-3-3.9Z"></path></svg>Non</button></div></div><form data-step="comment" hidden><label for="hgdc-feedback-comment">Qu'est-ce qui manquait ou pourrait être plus clair ? (facultatif)</label><textarea id="hgdc-feedback-comment" name="comment" rows="3" maxlength="1000"></textarea><div class="hgdc-feedback__choices"><button type="submit">Envoyer</button><button type="button" data-skip>Passer</button></div></form><p data-step="done" class="hgdc-feedback__done" role="status" hidden>Merci, c'est noté.</p></hgdc-feedback><nav class="hd-pagination not-content" aria-label="Pages voisines" data-pagefind-ignore><a class="hd-pagination__link hd-pagination__link--next" href="/reference/cli/" rel="next"><span class="hd-pagination__hint">Suivant<svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="m9 6 6 6-6 6"></path></svg></span><span class="hd-pagination__title">Commande hgdc-docs</span></a></nav><script type="module" src="/_astro/Footer.astro_astro_type_script_index_0_lang.DzCnn3OT.js"></script></div></div></main><form class="hd-askbar" data-askbar data-pagefind-ignore><label class="sr-only" for="hd-askbar-input">Pose une question à l'assistant</label><input id="hd-askbar-input" data-askbar-input type="text" maxlength="1000" placeholder="Pose une question…" autocomplete="off"><kbd class="hd-kbd" data-shortcut aria-hidden="true">Ctrl I</kbd><button type="submit" class="hd-send" aria-label="Envoyer la question"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 19V5m-6 6 6-6 6 6"></path></svg></button></form></div><aside class="hd-columns__toc" aria-label="Sur cette page"><div class="hd-toc-scroll"><starlight-toc data-min-h="2" data-max-h="3"><nav aria-labelledby="starlight__on-this-page"><h2 id="starlight__on-this-page">Sur cette page</h2><ul class="astro-cxnrsawo" style="--depth: 0;"><li style="--depth: 0;" class="astro-cxnrsawo"><a href="#_top" style="--depth: 0;" class="astro-cxnrsawo"><span style="--depth: 0;" class="astro-cxnrsawo">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-cxnrsawo"><a href="#champs" style="--depth: 0;" class="astro-cxnrsawo"><span style="--depth: 0;" class="astro-cxnrsawo">Champs</span></a></li><li style="--depth: 0;" class="astro-cxnrsawo"><a href="#navigation" style="--depth: 0;" class="astro-cxnrsawo"><span style="--depth: 0;" class="astro-cxnrsawo">Navigation</span></a></li><li style="--depth: 0;" class="astro-cxnrsawo"><a href="#erreurs" style="--depth: 0;" class="astro-cxnrsawo"><span style="--depth: 0;" class="astro-cxnrsawo">Erreurs</span></a></li></ul></nav></starlight-toc><script type="module">var e=`_top`,t=class extends HTMLElement{_current=this.querySelector(`a[aria-current="true"]`);minH=parseInt(this.dataset.minH||`2`,10);maxH=parseInt(this.dataset.maxH||`3`,10);tocHeadingSelector=`h1#${e},:where(${[...Array.from({length:1+this.maxH-this.minH}).map((e,t)=>`h${this.minH+t}`)].join()})[id]`;set current(e){e!==this._current&&(this._current&&this._current.removeAttribute(`aria-current`),e.setAttribute(`aria-current`,`true`),this._current=e)}onIdle=e=>(window.requestIdleCallback||(e=>setTimeout(e,1)))(e);constructor(){super(),this.onIdle(()=>this.init())}init=()=>{let t=[...this.querySelectorAll(`a`)],n=e=>e.matches(this.tocHeadingSelector),r=t=>{for(;t;){if(t.matches(`.sl-markdown-content, main > *`))return document.getElementById(e);if(n(t))return t;let r=t.querySelector(this.tocHeadingSelector);if(r)return r;let i=t.previousElementSibling;for(;i?.lastElementChild;)i=i.lastElementChild;t=i??t.parentElement}return null},i=e=>{for(let{isIntersecting:n,target:i}of e){if(!n)continue;let e=r(i);if(!e)continue;let a=t.find(t=>t.hash===`#`+encodeURIComponent(e.id));if(a){this.current=a;break}}},a=document.querySelectorAll([`main :where(${this.tocHeadingSelector})`,`main :where(${this.tocHeadingSelector}, .sl-heading-wrapper) ~ *:not(:has(${this.tocHeadingSelector}))`,`main .sl-markdown-content > *:not(:has(${this.tocHeadingSelector}))`,`main > *:not(:has(${this.tocHeadingSelector}))`].join()),o,s=()=>{o||(o=new IntersectionObserver(i,{rootMargin:this.getRootMargin()}),a.forEach(e=>o.observe(e)))};s();let c;window.addEventListener(`resize`,()=>{o&&=(o.disconnect(),void 0),clearTimeout(c),c=setTimeout(()=>this.onIdle(s),200)})};getRootMargin(){let e=(document.querySelector(`header`)?.getBoundingClientRect().height||0)+(this.querySelector(`summary`)?.getBoundingClientRect().height||0)+32;return`-${e}px 0% ${e+53-document.documentElement.clientHeight}px`}};customElements.define(`starlight-toc`,t);</script></div></aside></div><footer class="hd-site-footer" data-pagefind-ignore><div class="hd-site-footer__row"><a class="hd-brand hd-brand--footer" href="/"><span class="hd-brand__mark"><img class="hd-brand__light" src="/images/logo-clair.svg" alt="" width="20" height="20" loading="lazy"><img class="hd-brand__dark" src="/images/logo-sombre.svg" alt="" width="20" height="20" loading="lazy"></span><span class="hd-brand__name">Docs</span></a></div><div class="hd-site-footer__row hd-site-footer__row--meta"><p>Écrire une documentation en MDX, la publier avec Host et y brancher un assistant IA qui cite ses sources.</p><div class="hd-theme-choice" role="radiogroup" aria-label="Thème"><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="auto" aria-label="Système" title="Système"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 5h16a1 1 0 0 1 1 1v10a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1Zm4 15h8m-4-3v3"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="light" aria-label="Clair" title="Clair"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 16a4 4 0 1 0 0-8 4 4 0 0 0 0 8ZM12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"></path></svg></button><button type="button" role="radio" aria-checked="false" data-hd-theme-choice="dark" aria-label="Sombre" title="Sombre"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5Z"></path></svg></button></div></div></footer></div><hgdc-assistant data-endpoint="https://docs.hgdc.ch/api/v1/ask" data-project="jn7dj6vzkgs7n2d16kqjtb99yd8gbdw0" data-name="Docs"><section class="hgdc-panel" role="dialog" aria-modal="false" aria-labelledby="hgdc-assistant-title" data-panel inert><div class="hgdc-panel__grip" aria-hidden="true"></div><header class="hgdc-panel__header"><h2 id="hgdc-assistant-title"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 3.5 13.6 8a3 3 0 0 0 1.9 1.9L20 11.5l-4.5 1.6a3 3 0 0 0-1.9 1.9L12 19.5 10.4 15a3 3 0 0 0-1.9-1.9L4 11.5 8.5 9.9A3 3 0 0 0 10.4 8ZM19 3v3M20.5 4.5h-3"></path></svg>Assistant</h2><div class="hgdc-panel__tools"><button type="button" class="hd-icon-button" data-reset aria-label="Nouvelle conversation" title="Nouvelle conversation" hidden><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M4 12a8 8 0 1 0 2.3-5.7M4 4v4h4"></path></svg></button><button type="button" class="hd-icon-button" data-close aria-label="Fermer l'assistant" title="Fermer (Échap)"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M6 6l12 12M18 6 6 18"></path></svg></button></div></header><div class="hgdc-panel__body" data-log aria-live="polite"><div class="hgdc-empty" data-empty><p class="hgdc-empty__title">Pose ta question sur Docs.</p><p>Je cherche dans les pages de cette documentation et je cite mes sources. Si la réponse n'y est pas, je te le dis.</p></div></div><form class="hgdc-panel__form" data-form><label class="sr-only" for="hgdc-question">Ta question</label><textarea id="hgdc-question" data-input rows="1" maxlength="1000" placeholder="Pose une question…" required></textarea><button type="submit" class="hd-send" data-send aria-label="Envoyer la question"><svg class="hd-icon" aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M12 19V5m-6 6 6-6 6 6"></path></svg></button></form><p class="hgdc-panel__note">Réponses générées par IA (Claude, d'Anthropic), à vérifier. Les questions sont conservées 90 jours pour améliorer cette documentation.</p></section></hgdc-assistant><script type="module" src="/_astro/Assistant.astro_astro_type_script_index_0_lang.C1pz7yK1.js"></script></div><script type="module">var e=class extends HTMLElement{connectedCallback(){let e=matchMedia(`(min-width: 50em)`),t=()=>{e.matches&&this.matches(`:popover-open`)&&this.hidePopover(),this.popover=e.matches?null:`auto`};t(),e.addEventListener(`change`,t),this.addEventListener(`toggle`,e=>{let t=e.newState===`open`;for(let e of document.querySelectorAll(`.hd-main-frame, .hd-askbar`))e.toggleAttribute(`inert`,t);document.documentElement.toggleAttribute(`data-hd-menu`,t)}),this.addEventListener(`click`,e=>{e.target.closest(`a`)&&this.matches(`:popover-open`)&&this.hidePopover()})}};customElements.define(`hd-sidebar-pane`,e);</script></body></html>

package/template/.build/reference/docs-json.md

@@ -0,0 +1,47 @@
+# docs.json
+
+`docs.json` vit à la racine du dossier de la doc. Il reprend le format de Mintlify : les champs que Docs ne gère pas sont acceptés et ignorés. Pour l’autocomplétion dans ton éditeur, ajoute `"$schema": "https://docs.hgdc.ch/docs.schema.json"`.
+
+## Champs
+
+| Champ                | Type                                          | Obligatoire | Rôle                                                                                                                                                                                                                                                                                                                                              |
+| -------------------- | --------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`               | texte                                         | oui         | Nom de la doc, en tête du site et dans `llms.txt`. 80 caractères au plus.                                                                                                                                                                                                                                                                         |
+| `description`        | texte                                         | non         | Une phrase de présentation.                                                                                                                                                                                                                                                                                                                       |
+| `navigation`         | objet                                         | oui         | Pages, groupes, onglets ou versions. Voir [Navigation](/guides/navigation/).                                                                                                                                                                                                                                                                      |
+| `project`            | texte                                         | non         | Identifiant du projet dans la console. Active l’assistant et l’indexation.                                                                                                                                                                                                                                                                        |
+| `language`           | `fr`, `en`, `de`, `it`                        | non         | Langue de l’interface du site. `fr` par défaut.                                                                                                                                                                                                                                                                                                   |
+| `base`               | texte                                         | non         | Sous-chemin où la doc est servie, par exemple `/docs` quand ton application la publie derrière un proxy (`https://app.acme.ch/docs`). Liens, images, recherche, `llms.txt` et pages `.md` le portent ; le site est écrit dans `dist/docs/`. Écris tes liens depuis la racine de la doc (`/guides/publier/`) : le sous-chemin est ajouté au build. |
+| `colors.primary`     | couleur `#rrggbb`                             | non         | Couleur des liens et des éléments actifs.                                                                                                                                                                                                                                                                                                         |
+| `colors.dark`        | couleur `#rrggbb`                             | non         | La même, en mode sombre.                                                                                                                                                                                                                                                                                                                          |
+| `logo`               | chemin, ou `{ light, dark }`                  | non         | Logo affiché en tête.                                                                                                                                                                                                                                                                                                                             |
+| `favicon`            | chemin                                        | non         | Icône de l’onglet du navigateur.                                                                                                                                                                                                                                                                                                                  |
+| `navbar.links`       | liste de `{ label, href }`                    | non         | Jusqu’à 5 liens dans la barre du haut (adresses complètes).                                                                                                                                                                                                                                                                                       |
+| `navbar.primary`     | `{ label, href }`                             | non         | Bouton mis en avant à droite de la barre du haut.                                                                                                                                                                                                                                                                                                 |
+| `footer.socials`     | objet                                         | non         | Liens vers tes réseaux : `linkedin`, `github`, `gitlab`, `x`, `youtube`, `instagram`, `facebook`, `discord`, `mastodon`, `bluesky`, `website`.                                                                                                                                                                                                    |
+| `redirects`          | liste de `{ source, destination, permanent }` | non         | Anciennes adresses qui mènent aux nouvelles. `source` est un chemin du site (`/guides/ancien`), `destination` un chemin ou une adresse `https://`. `permanent: false` pour une redirection temporaire. 500 au plus.                                                                                                                               |
+| `assistant.enabled`  | oui / non                                     | non         | `false` cache l’assistant du site.                                                                                                                                                                                                                                                                                                                |
+| `assistant.endpoint` | adresse                                       | non         | API de l’assistant, à ne changer que pour un environnement de test.                                                                                                                                                                                                                                                                               |
+
+## Navigation
+
+Quatre formes, une seule à la fois :
+
+| Forme      | Exemple                                                   |
+| ---------- | --------------------------------------------------------- |
+| `pages`    | `["index", "installation"]`                               |
+| `groups`   | `[{ "group": "Démarrer", "pages": ["index"] }]`           |
+| `tabs`     | `[{ "tab": "Guides", "groups": [...] }]`                  |
+| `versions` | `[{ "version": "v2", "default": true, "groups": [...] }]` |
+
+Un groupe accepte `expanded: false` pour être replié par défaut, et peut contenir des groupes.
+
+## Erreurs
+
+Un `docs.json` invalide fait échouer le build avec la liste des problèmes, par exemple :
+
+```text
+docs.json invalide :
+- colors.primary : couleur attendue au format #rrggbb
+- navigation : utiliser une seule forme parmi versions, tabs, groups ou pages
+```