@hgdc/docs 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs.schema.json +21 -0
- package/package.json +3 -1
- package/src/build/auto-import.ts +5 -24
- package/src/core/components.ts +166 -0
- package/src/core/config.ts +42 -0
- package/src/core/feedback-api.ts +17 -0
- package/src/core/validate.ts +276 -0
- package/src/integration.ts +29 -15
- package/src/overrides/Footer.astro +154 -0
- package/src/overrides/Head.astro +14 -14
- package/src/overrides/PageTitle.astro +95 -95
- package/src/overrides/Sidebar.astro +60 -60
- package/src/overrides/SocialIcons.astro +59 -0
- package/template/.astro/content-assets.mjs +4 -1
- package/template/.astro/content-modules.mjs +15 -15
- package/template/.build/.well-known/llms.txt +15 -15
- package/template/.build/404.html +5 -5
- package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.g9hoxVJg.js +1 -0
- package/template/.build/_astro/common.CQYUsl_5.css +3 -0
- package/template/.build/_astro/{ui-core.CrG20ya_.js → ui-core.Clh5jUUO.js} +1 -1
- package/template/.build/_hgdc/corpus.json +1 -1
- package/template/.build/demarrer/premiere-doc/index.html +15 -15
- package/template/.build/demarrer/premiere-doc.md +3 -3
- package/template/.build/explications/donnees/index.html +10 -10
- package/template/.build/explications/fonctionnement/index.html +10 -11
- package/template/.build/guides/agents/index.html +11 -11
- package/template/.build/guides/agents.md +1 -1
- package/template/.build/guides/assistant/index.html +11 -11
- package/template/.build/guides/composants/index.html +19 -19
- package/template/.build/guides/composants.md +10 -8
- package/template/.build/guides/ecrire/index.html +12 -13
- package/template/.build/guides/elements/index.html +1 -0
- package/template/.build/guides/navigation/index.html +12 -13
- package/template/.build/guides/publier/index.html +14 -23
- package/template/.build/guides/publier.md +1 -1
- package/template/.build/guides/theme/index.html +12 -13
- package/template/.build/index.html +11 -12
- package/template/.build/index.md +9 -9
- package/template/.build/llms-full.txt +59 -63
- package/template/.build/llms.txt +15 -15
- package/template/.build/pagefind/fragment/fr-ch_148313b.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_35f556a.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_48ca71e.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_c589c2a.pf_fragment +0 -0
- package/template/.build/pagefind/index/fr-ch_c5ced52.pf_index +0 -0
- package/template/.build/pagefind/pagefind-entry.json +1 -1
- package/template/.build/pagefind/pagefind.fr-ch_8a246aa922758.pf_meta +0 -0
- package/template/.build/reference/api-assistant/index.html +12 -12
- package/template/.build/reference/api-assistant.md +2 -12
- package/template/.build/reference/cli/index.html +10 -10
- package/template/.build/reference/docs-json/index.html +35 -11
- package/template/.build/reference/docs-json.md +18 -14
- package/template/.build/reference/mcp/index.html +11 -11
- package/template/node_modules/.vite/deps/_metadata.json +8 -8
- package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.Cn3-p701.js +0 -1
- package/template/.build/_astro/common.C-MpX45O.css +0 -3
- package/template/.build/pagefind/fragment/fr-ch_68e734b.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_cfa4336.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_e02aa49.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_e254a54.pf_fragment +0 -0
- package/template/.build/pagefind/index/fr-ch_a71411b.pf_index +0 -0
- package/template/.build/pagefind/pagefind.fr-ch_2f3ea8fccf961.pf_meta +0 -0
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!DOCTYPE html><html lang="fr-CH" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-
|
|
1
|
+
<!DOCTYPE html><html lang="fr-CH" dir="ltr" data-theme="dark" data-has-toc data-has-sidebar class="astro-ymcefofk"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Bienvenue dans Docs | Docs</title><style>:root{--sl-color-accent-low:#282041;--sl-color-accent:#9258ff;--sl-color-accent-high:#e8b7ff;--hgdc-on-accent:#000000;}:root[data-theme="light"]{--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="Bienvenue dans Docs"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Ta documentation en MDX, publiée par Host, avec recherche, llms.txt et un assistant IA qui cite ses sources."/><meta property="og:site_name" content="Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Ta documentation en MDX, publiée par Host, avec recherche, llms.txt et un assistant IA qui cite ses sources."/><link rel="alternate" type="text/markdown" href="/index.md"><link rel="describedby" type="text/markdown" href="/llms.txt"><script>
|
|
2
2
|
window.StarlightThemeProvider = (() => {
|
|
3
3
|
const storedTheme =
|
|
4
4
|
typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
|
|
@@ -24,9 +24,9 @@
|
|
|
24
24
|
},
|
|
25
25
|
};
|
|
26
26
|
})();
|
|
27
|
-
</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-
|
|
28
|
-
</style><script type="module" src="/
|
|
29
|
-
</style></head><body class="astro-
|
|
27
|
+
</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M5 12a1 1 0 0 0-1-1H3a1 1 0 0 0 0 2h1a1 1 0 0 0 1-1Zm.64 5-.71.71a1 1 0 0 0 0 1.41 1 1 0 0 0 1.41 0l.71-.71A1 1 0 0 0 5.64 17ZM12 5a1 1 0 0 0 1-1V3a1 1 0 0 0-2 0v1a1 1 0 0 0 1 1Zm5.66 2.34a1 1 0 0 0 .7-.29l.71-.71a1 1 0 1 0-1.41-1.41l-.66.71a1 1 0 0 0 0 1.41 1 1 0 0 0 .66.29Zm-12-.29a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.71-.71a1.004 1.004 0 1 0-1.43 1.41l.73.71ZM21 11h-1a1 1 0 0 0 0 2h1a1 1 0 0 0 0-2Zm-2.64 6A1 1 0 0 0 17 18.36l.71.71a1 1 0 0 0 1.41 0 1 1 0 0 0 0-1.41l-.76-.66ZM12 6.5a5.5 5.5 0 1 0 5.5 5.5A5.51 5.51 0 0 0 12 6.5Zm0 9a3.5 3.5 0 1 1 0-7 3.5 3.5 0 0 1 0 7Zm0 3.5a1 1 0 0 0-1 1v1a1 1 0 0 0 2 0v-1a1 1 0 0 0-1-1Z"/></svg><svg aria-hidden="true" class="dark astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.64 13a1 1 0 0 0-1.05-.14 8.049 8.049 0 0 1-3.37.73 8.15 8.15 0 0 1-8.14-8.1 8.59 8.59 0 0 1 .25-2A1 1 0 0 0 8 2.36a10.14 10.14 0 1 0 14 11.69 1 1 0 0 0-.36-1.05Zm-9.5 6.69A8.14 8.14 0 0 1 7.08 5.22v.27a10.15 10.15 0 0 0 10.14 10.14 9.784 9.784 0 0 0 2.1-.22 8.11 8.11 0 0 1-7.18 4.32v-.04Z"/></svg><svg aria-hidden="true" class="auto astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg></template><link rel="stylesheet" href="/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/_astro/common.CQYUsl_5.css"><style>@layer starlight.components{svg:where(.astro-nqfvd567){color:var(--sl-icon-color);font-size:var(--sl-icon-size,1em);width:1em;height:1em;overflow:visible}}
|
|
28
|
+
</style><script type="module" src="/_astro/page.cNngjUgL.js"></script><style>@layer starlight.components{starlight-tabs:where(.astro-ygjryhu4){display:block}.tablist-wrapper:where(.astro-ygjryhu4){overflow-x:auto}:where(.astro-ygjryhu4)[role=tablist]{border-bottom:2px solid var(--sl-color-gray-5);padding:0;list-style:none;display:flex}.tab:where(.astro-ygjryhu4){display:flex}.tab:where(.astro-ygjryhu4)>:where(.astro-ygjryhu4)[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-ygjryhu4) :where(.astro-ygjryhu4)[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-ygjryhu4)~[role=tabpanel]{margin-top:1rem}}
|
|
29
|
+
</style></head><body class="astro-ymcefofk"><a class="sl-skip-link astro-tlkpuiw6" href="#_top">Aller au contenu</a><div class="page sl-flex astro-ydkobtgc"><header class="header astro-ydkobtgc"><div class="header astro-ktmtoxfz"><div class="title-wrapper sl-flex astro-ktmtoxfz"><a href="/" class="site-title sl-flex astro-bbrnas37"><img class="light:sl-hidden print:hidden astro-bbrnas37" alt src="/_astro/logo-sombre.BkgsFXxh.svg" width="32" height="32"><img class="dark:sl-hidden print:block astro-bbrnas37" alt src="/_astro/logo-clair.BqNh6JNi.svg" width="32" height="32"><span class="astro-bbrnas37" translate="no">Docs</span></a></div><div class="sl-flex print:hidden astro-ktmtoxfz"><site-search class="astro-ktmtoxfz astro-duncofyt" data-translations="{"placeholder":"Rechercher"}"><button data-open-modal disabled aria-label="Rechercher" aria-keyshortcuts="Control+K" class="astro-duncofyt"><svg aria-hidden="true" class="astro-duncofyt astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"/></svg><span class="sl-hidden md:sl-block astro-duncofyt" aria-hidden="true">Rechercher</span><kbd class="sl-hidden md:sl-flex astro-duncofyt" style="display: none;"><kbd class="astro-duncofyt">Ctrl</kbd><kbd class="astro-duncofyt">K</kbd></kbd></button><dialog style="padding:0" aria-label="Rechercher" class="astro-duncofyt"><div class="dialog-frame sl-flex astro-duncofyt"><button data-close-modal class="sl-flex md:sl-hidden astro-duncofyt">Annuler</button><div class="search-container astro-duncofyt"><div id="starlight__search" class="astro-duncofyt"></div></div></div></dialog></site-search><script>
|
|
30
30
|
(() => {
|
|
31
31
|
const openBtn = document.querySelector('button[data-open-modal]');
|
|
32
32
|
const shortcut = openBtn?.querySelector('kbd');
|
|
@@ -38,9 +38,9 @@
|
|
|
38
38
|
}
|
|
39
39
|
shortcut.style.display = '';
|
|
40
40
|
})();
|
|
41
|
-
</script><script type="module" src="/
|
|
41
|
+
</script><script type="module" src="/_astro/Search.astro_astro_type_script_index_0_lang.g9hoxVJg.js"></script></div><div class="sl-hidden md:sl-flex print:hidden right-group astro-ktmtoxfz"><div class="sl-flex social-icons astro-ktmtoxfz"><nav class="hgdc-navbar astro-uwuccqly" aria-label="Liens"><a class="hgdc-navbar__link astro-uwuccqly" href="https://hgdc.ch">HGDC</a><a class="hgdc-navbar__primary astro-uwuccqly" href="https://docs.hgdc.ch">Console</a></nav></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-mayj4s7h"><span class="sr-only astro-mayj4s7h">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-mayj4s7h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg><select autocomplete="off" class="astro-mayj4s7h"><option value="dark" class="astro-mayj4s7h">Sombre</option><option value="light" class="astro-mayj4s7h">Clair</option><option value="auto" selected class="astro-mayj4s7h">Auto</option></select><svg aria-hidden="true" class="icon caret astro-mayj4s7h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg></label></starlight-theme-select><script>
|
|
42
42
|
StarlightThemeProvider.updatePickers();
|
|
43
|
-
</script><script type="module">var e=`starlight-theme`,t=e=>e===`auto`||e===`dark`||e===`light`?e:`auto`,n=()=>t(typeof localStorage<`u`&&localStorage.getItem(e));function r(t){typeof localStorage<`u`&&localStorage.setItem(e,t===`light`||t===`dark`?t:``)}var i=()=>matchMedia(`(prefers-color-scheme: light)`).matches?`light`:`dark`;function a(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e===`auto`?i():e,r(e)}matchMedia(`(prefers-color-scheme: light)`).addEventListener(`change`,()=>{n()===`auto`&&a(`auto`)});var o=class extends HTMLElement{constructor(){super(),a(n()),this.querySelector(`select`)?.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&a(t(e.currentTarget.value))})}};customElements.define(`starlight-theme-select`,o);</script><script type="module">var e=class extends HTMLElement{constructor(){super();let e=this.querySelector(`select`);e&&(e.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=e.currentTarget.value)}),window.addEventListener(`pageshow`,t=>{if(!t.persisted)return;let n=e.querySelector(`option[selected]`)?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}};customElements.define(`starlight-lang-select`,e);</script></div></div></header><nav class="sidebar print:hidden astro-
|
|
43
|
+
</script><script type="module">var e=`starlight-theme`,t=e=>e===`auto`||e===`dark`||e===`light`?e:`auto`,n=()=>t(typeof localStorage<`u`&&localStorage.getItem(e));function r(t){typeof localStorage<`u`&&localStorage.setItem(e,t===`light`||t===`dark`?t:``)}var i=()=>matchMedia(`(prefers-color-scheme: light)`).matches?`light`:`dark`;function a(e){StarlightThemeProvider.updatePickers(e),document.documentElement.dataset.theme=e===`auto`?i():e,r(e)}matchMedia(`(prefers-color-scheme: light)`).addEventListener(`change`,()=>{n()===`auto`&&a(`auto`)});var o=class extends HTMLElement{constructor(){super(),a(n()),this.querySelector(`select`)?.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&a(t(e.currentTarget.value))})}};customElements.define(`starlight-theme-select`,o);</script><script type="module">var e=class extends HTMLElement{constructor(){super();let e=this.querySelector(`select`);e&&(e.addEventListener(`change`,e=>{e.currentTarget instanceof HTMLSelectElement&&(window.location.pathname=e.currentTarget.value)}),window.addEventListener(`pageshow`,t=>{if(!t.persisted)return;let n=e.querySelector(`option[selected]`)?.index;n!==e.selectedIndex&&(e.selectedIndex=n??0)}))}};customElements.define(`starlight-lang-select`,e);</script></div></div></header><nav class="sidebar print:hidden astro-ydkobtgc" aria-label="principale"><button popovertarget="starlight__sidebar" class="sl-menu-button sl-flex md:sl-hidden print:hidden astro-gte3465h"><svg aria-hidden="true" class="open-menu astro-gte3465h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg><svg aria-hidden="true" class="close-menu astro-gte3465h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg><span class="sr-only astro-gte3465h">Menu</span></button><script type="module">var e=class extends HTMLElement{constructor(){super();let e=matchMedia(`(min-width: 50em)`),t=()=>{this.popover=e.matches?null:`auto`};t(),e.addEventListener(`change`,()=>t()),this.addEventListener(`toggle`,({newState:e})=>this.trapFocus(e===`open`))}trapFocus(e){document.querySelectorAll(`.main-frame, .sl-skip-link`).forEach(t=>{t.toggleAttribute(`inert`,e)})}};customElements.define(`sl-sidebar-pane`,e);</script><script type="module">for(let e of document.querySelectorAll(`[data-hgdc-version]`))e.addEventListener(`change`,()=>window.location.assign(e.value));</script><sl-sidebar-pane popover id="starlight__sidebar" class="sidebar-pane astro-ydkobtgc"><div class="sidebar-content sl-flex astro-ydkobtgc"><div class="hgdc-sections"><nav aria-label="Sections de la documentation"><ul class="hgdc-tabs"><li><a href="/" aria-current="page">Guides</a></li><li><a href="/reference/docs-json/">Référence</a></li><li><a href="/explications/fonctionnement/">Explications</a></li></ul></nav></div><sl-sidebar-state-persist data-hash="1b1wzvo" class="astro-frdowxs4"><script aria-hidden="true">
|
|
44
44
|
(() => {
|
|
45
45
|
try {
|
|
46
46
|
if (!matchMedia('(min-width: 50em)').matches) return;
|
|
@@ -63,17 +63,17 @@
|
|
|
63
63
|
);
|
|
64
64
|
} catch {}
|
|
65
65
|
})();
|
|
66
|
-
</script><ul class="top-level astro-
|
|
66
|
+
</script><ul class="top-level astro-3fgxvckv"><li class="astro-3fgxvckv"><details open class="astro-3fgxvckv"><summary class="astro-3fgxvckv"><span class="group-label astro-3fgxvckv"><span class="large astro-3fgxvckv">Démarrer</span></span><svg aria-hidden="true" class="caret astro-3fgxvckv astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></summary><sl-sidebar-restore data-index="0"></sl-sidebar-restore><ul class="astro-3fgxvckv"><li class="astro-3fgxvckv"><a href="/" aria-current="page" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Bienvenue</span></a></li><li class="astro-3fgxvckv"><a href="/demarrer/premiere-doc/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Ta première doc</span></a></li><li class="astro-3fgxvckv"><a href="/guides/publier/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Publier</span></a></li></ul></details></li><li class="astro-3fgxvckv"><details open class="astro-3fgxvckv"><summary class="astro-3fgxvckv"><span class="group-label astro-3fgxvckv"><span class="large astro-3fgxvckv">Écrire</span></span><svg aria-hidden="true" class="caret astro-3fgxvckv astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></summary><sl-sidebar-restore data-index="1"></sl-sidebar-restore><ul class="astro-3fgxvckv"><li class="astro-3fgxvckv"><a href="/guides/ecrire/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Écrire en MDX</span></a></li><li class="astro-3fgxvckv"><a href="/guides/composants/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Composants</span></a></li><li class="astro-3fgxvckv"><a href="/guides/navigation/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Navigation</span></a></li><li class="astro-3fgxvckv"><a href="/guides/theme/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Thème et logo</span></a></li></ul></details></li><li class="astro-3fgxvckv"><details open class="astro-3fgxvckv"><summary class="astro-3fgxvckv"><span class="group-label astro-3fgxvckv"><span class="large astro-3fgxvckv">Assistant et agents</span></span><svg aria-hidden="true" class="caret astro-3fgxvckv astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.25rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></summary><sl-sidebar-restore data-index="2"></sl-sidebar-restore><ul class="astro-3fgxvckv"><li class="astro-3fgxvckv"><a href="/guides/assistant/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Assistant</span></a></li><li class="astro-3fgxvckv"><a href="/guides/agents/" class="astro-3fgxvckv"><span class="astro-3fgxvckv">Pour les agents</span></a></li></ul></details></li></ul><script aria-hidden="true">
|
|
67
67
|
(() => {
|
|
68
68
|
const scroller = document.getElementById('starlight__sidebar');
|
|
69
69
|
if (!window._starlightScrollRestore || !scroller) return;
|
|
70
70
|
scroller.scrollTop = window._starlightScrollRestore;
|
|
71
71
|
delete window._starlightScrollRestore;
|
|
72
72
|
})();
|
|
73
|
-
</script></sl-sidebar-state-persist><div class="md:sl-hidden"><div class="mobile-preferences sl-flex astro-
|
|
73
|
+
</script></sl-sidebar-state-persist><div class="md:sl-hidden"><div class="mobile-preferences sl-flex astro-nkgiahr6"><div class="social-icons astro-nkgiahr6"><nav class="hgdc-navbar astro-uwuccqly" aria-label="Liens"><a class="hgdc-navbar__link astro-uwuccqly" href="https://hgdc.ch">HGDC</a><a class="hgdc-navbar__primary astro-uwuccqly" href="https://docs.hgdc.ch">Console</a></nav></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-mayj4s7h"><span class="sr-only astro-mayj4s7h">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-mayj4s7h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M21 14h-1V7a3 3 0 0 0-3-3H7a3 3 0 0 0-3 3v7H3a1 1 0 0 0-1 1v2a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-2a1 1 0 0 0-1-1ZM6 7a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v7H6V7Zm14 10a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1v-1h16v1Z"/></svg><select autocomplete="off" class="astro-mayj4s7h"><option value="dark" class="astro-mayj4s7h">Sombre</option><option value="light" class="astro-mayj4s7h">Clair</option><option value="auto" selected class="astro-mayj4s7h">Auto</option></select><svg aria-hidden="true" class="icon caret astro-mayj4s7h astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M17 9.17a1 1 0 0 0-1.41 0L12 12.71 8.46 9.17a1 1 0 1 0-1.41 1.42l4.24 4.24a1.002 1.002 0 0 0 1.42 0L17 10.59a1.002 1.002 0 0 0 0-1.42Z"/></svg></label></starlight-theme-select><script>
|
|
74
74
|
StarlightThemeProvider.updatePickers();
|
|
75
|
-
</script></div></div></div></sl-sidebar-pane></nav><div class="main-frame astro-
|
|
76
|
-
<div class="hgdc-card-group not-content" style="--hgdc-cols:2"><a href="/
|
|
75
|
+
</script></div></div></div></sl-sidebar-pane></nav><div class="main-frame astro-ydkobtgc"><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="lg:sl-flex astro-qp7kgym3"><aside class="right-sidebar-container print:hidden astro-qp7kgym3"><div class="right-sidebar astro-qp7kgym3"><div class="lg:sl-hidden astro-mojbznwa"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-z4ijp526"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-z4ijp526"><details id="starlight__mobile-toc" class="astro-z4ijp526"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-z4ijp526"><span class="toggle sl-flex astro-z4ijp526">Sur cette page<svg aria-hidden="true" class="caret astro-z4ijp526 astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1rem;"><path d="m14.83 11.29-4.24-4.24a1 1 0 1 0-1.42 1.41L12.71 12l-3.54 3.54a1 1 0 0 0 0 1.41 1 1 0 0 0 .71.29 1 1 0 0 0 .71-.29l4.24-4.24a1.002 1.002 0 0 0 0-1.42Z"/></svg></span><span class="display-current astro-z4ijp526"></span></summary><div class="dropdown astro-z4ijp526"><ul class="isMobile astro-vrgp5ku5" style="--depth: 0;"><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#_top" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#ce-que-tu-obtiens" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Ce que tu obtiens</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#compatible-avec-mintlify" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Compatible avec Mintlify</span></a></li></ul></div></details></nav></mobile-starlight-toc><script type="module" src="/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.C3fM4Kra.js"></script></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-mojbznwa"><div class="sl-container astro-mojbznwa"><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-vrgp5ku5" style="--depth: 0;"><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#_top" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#ce-que-tu-obtiens" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Ce que tu obtiens</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#compatible-avec-mintlify" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Compatible avec Mintlify</span></a></li></ul></nav></starlight-toc><script type="module" src="/_astro/TableOfContents.astro_astro_type_script_index_0_lang.BpJaGz7G.js"></script></div></div></div></aside><div class="main-pane astro-qp7kgym3"><main data-pagefind-body class="astro-ymcefofk" lang="fr-CH" dir="ltr"><div class="content-panel astro-u747o4dk"><div class="sl-container astro-u747o4dk"><div class="hgdc-title"><h1 id="_top" class="astro-7gbl5cwn">Bienvenue dans Docs</h1><div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore><button type="button" class="hgdc-action" data-hgdc-copy="/index.md"><svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"><rect x="8" y="8" width="12" height="12" rx="3" fill="none" stroke="currentColor" stroke-width="1.8"></rect><path d="M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2" fill="none" stroke="currentColor" stroke-width="1.8"></path></svg><span data-label>Copier pour un LLM</span></button><details class="hgdc-menu"><summary class="hgdc-action hgdc-action--icon" aria-label="Autres formats de la page"><svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"><path d="m6 9 6 6 6-6" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path></svg></summary><ul class="hgdc-menu__list"><li><a href="/index.md">Voir en Markdown</a></li><li><a data-hgdc-open="claude" href="https://claude.ai/new" target="_blank" rel="noopener">Ouvrir dans Claude</a></li><li><a data-hgdc-open="chatgpt" href="https://chatgpt.com/" target="_blank" rel="noopener">Ouvrir dans ChatGPT</a></li><li><a href="/llms.txt">Index pour les agents (llms.txt)</a></li></ul></details><button type="button" class="hgdc-action" data-hgdc-ask><svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16"><path d="M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9z" fill="currentColor"></path></svg><span>Demander à l'assistant</span></button><span class="sr-only" role="status" aria-live="polite" data-hgdc-copy-status></span></div></div><script type="module">var e=document.querySelector(`[data-hgdc-copy-status]`);for(let t of document.querySelectorAll(`[data-hgdc-copy]`)){let n=t.querySelector(`[data-label]`);t.addEventListener(`click`,async()=>{let r=t=>{n.textContent=t,e&&(e.textContent=t),setTimeout(()=>n.textContent=`Copier pour un LLM`,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`)}})}var t=`Lis ${new URL(document.querySelector(`[data-hgdc-copy]`).dataset.hgdcCopy,location.href).href} et réponds à mes questions sur cette page.`;for(let e of document.querySelectorAll(`[data-hgdc-open]`))e.href=`${e.dataset.hgdcOpen===`claude`?`https://claude.ai/new`:`https://chatgpt.com/`}?q=${encodeURIComponent(t)}`;for(let e of document.querySelectorAll(`.hgdc-menu`))document.addEventListener(`click`,t=>{e.open&&!e.contains(t.target)&&(e.open=!1)}),e.addEventListener(`keydown`,t=>{t.key===`Escape`&&e.open&&(e.open=!1,e.querySelector(`summary`)?.focus())});for(let e of document.querySelectorAll(`[data-hgdc-ask]`))e.addEventListener(`click`,()=>document.dispatchEvent(new CustomEvent(`hgdc:assistant-open`)));</script></div></div><div class="content-panel astro-u747o4dk"><div class="sl-container astro-u747o4dk"><div class="sl-markdown-content"><p>Docs transforme un dossier de pages MDX en site de documentation. Tu écris dans ton dépôt Git, Host publie le site à chaque push, et la console <code>docs.hgdc.ch</code> branche un assistant qui répond à tes visiteurs à partir de ta doc, et de rien d’autre.</p>
|
|
76
|
+
<div class="hgdc-card-group not-content" style="--hgdc-cols:2"><a href="/demarrer/premiere-doc/" class="hgdc-card hgdc-card--link"><span class="hgdc-card__title">Ta première doc</span><div class="hgdc-card__body"><p>Un dossier, un fichier <code>docs.json</code> et une page : ton site tourne en local en cinq minutes.</p></div></a><a href="/guides/publier/" class="hgdc-card hgdc-card--link"><span class="hgdc-card__title">Publier avec Host</span><div class="hgdc-card__body"><p>Relie le dépôt à Host : chaque push met le site à jour.</p></div></a><a href="/guides/assistant/" class="hgdc-card hgdc-card--link"><span class="hgdc-card__title">L'assistant IA</span><div class="hgdc-card__body"><p>Il répond aux questions de tes visiteurs et cite les pages qu’il a utilisées.</p></div></a><a href="/guides/agents/" class="hgdc-card hgdc-card--link"><span class="hgdc-card__title">Pour les agents</span><div class="hgdc-card__body"><p><code>llms.txt</code>, une version Markdown de chaque page et un serveur MCP en lecture.</p></div></a></div>
|
|
77
77
|
<h2 id="ce-que-tu-obtiens">Ce que tu obtiens</h2>
|
|
78
78
|
<ul>
|
|
79
79
|
<li><strong>Un site rapide et lisible</strong> : navigation par onglets et groupes, versions, mode clair et sombre, mise en page pensée pour le téléphone.</li>
|
|
@@ -84,5 +84,4 @@
|
|
|
84
84
|
</ul>
|
|
85
85
|
<h2 id="compatible-avec-mintlify">Compatible avec Mintlify</h2>
|
|
86
86
|
<p>Le fichier <code>docs.json</code> reprend celui de Mintlify : nom, couleurs, logo, navigation en onglets, groupes et versions. Les composants les plus courants (<code><Note></code>, <code><Steps></code>, <code><Card></code>, <code><Tabs></code>…) fonctionnent sans import. Une doc Mintlify se reprend en général sans réécrire les pages.</p>
|
|
87
|
-
<aside aria-label="Tout reste en Suisse quand c'est possible" class="starlight-aside starlight-aside--tip"><p class="starlight-aside__title" aria-hidden="true"><svg aria-hidden="true" class="starlight-aside__icon astro-
|
|
88
|
-
confidentialité</a>.</p></div></aside></div><footer class="sl-flex astro-p5aduut3"><div class="meta sl-flex astro-p5aduut3"></div><div class="pagination-links print:hidden astro-gf3kf27h" dir="ltr"><a href="/docs/demarrer/premiere-doc/" rel="next" class="astro-gf3kf27h"><svg aria-hidden="true" class="astro-gf3kf27h astro-sni56jbe" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17.92 11.62a1.001 1.001 0 0 0-.21-.33l-5-5a1.003 1.003 0 1 0-1.42 1.42l3.3 3.29H7a1 1 0 0 0 0 2h7.59l-3.3 3.29a1.002 1.002 0 0 0 .325 1.639 1 1 0 0 0 1.095-.219l5-5a1 1 0 0 0 .21-.33 1 1 0 0 0 0-.76Z"/></svg><span class="astro-gf3kf27h">Suivant<br class="astro-gf3kf27h"><span class="link-title astro-gf3kf27h">Ta première doc</span></span></a></div></footer></div></div></main></div></div></div></div><hgdc-assistant data-endpoint="https://docs.hgdc.ch/api/v1/ask" data-project="jn7dj6vzkgs7n2d16kqjtb99yd8gbdw0" data-name="Docs"><button type="button" class="hgdc-launcher" data-open aria-haspopup="dialog" aria-expanded="false"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9z" fill="currentColor"></path><path d="M18.5 15l.8 1.9 1.9.8-1.9.8-.8 1.9-.8-1.9-1.9-.8 1.9-.8z" fill="currentColor"></path></svg><span>Demander à l'IA</span><kbd class="hgdc-kbd" data-shortcut aria-hidden="true">Ctrl I</kbd></button><section class="hgdc-panel" role="dialog" aria-modal="false" aria-labelledby="hgdc-assistant-title" hidden><header class="hgdc-panel__header"><div><h2 id="hgdc-assistant-title">Assistant</h2><p>Répond à partir de cette documentation, avec ses sources.</p></div><div class="hgdc-panel__tools"><button type="button" class="hgdc-icon-button" data-reset aria-label="Nouvelle conversation" hidden><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M4 12a8 8 0 1 0 2.3-5.7M4 4v4h4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path></svg></button><button type="button" class="hgdc-icon-button" data-close aria-label="Fermer l'assistant"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M6 6l12 12M18 6 6 18" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></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="Comment publier ma doc ?" required></textarea><button type="submit" class="hgdc-send" data-send aria-label="Envoyer la question"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M12 19V5M5 12l7-7 7 7" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"></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="/docs/_astro/Assistant.astro_astro_type_script_index_0_lang.DWgmlr85.js"></script></body></html>
|
|
87
|
+
<aside aria-label="Tout reste en Suisse quand c'est possible" class="starlight-aside starlight-aside--tip"><p class="starlight-aside__title" aria-hidden="true"><svg aria-hidden="true" class="starlight-aside__icon astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path fill-rule="evenodd" d="M1.44 8.855v-.001l3.527-3.516c.34-.344.802-.541 1.285-.548h6.649l.947-.947c3.07-3.07 6.207-3.072 7.62-2.868a1.821 1.821 0 0 1 1.557 1.557c.204 1.413.203 4.55-2.868 7.62l-.946.946v6.649a1.845 1.845 0 0 1-.549 1.286l-3.516 3.528a1.844 1.844 0 0 1-3.11-.944l-.858-4.275-4.52-4.52-2.31-.463-1.964-.394A1.847 1.847 0 0 1 .98 10.693a1.843 1.843 0 0 1 .46-1.838Zm5.379 2.017-3.873-.776L6.32 6.733h4.638l-4.14 4.14Zm8.403-5.655c2.459-2.46 4.856-2.463 5.89-2.33.134 1.035.13 3.432-2.329 5.891l-6.71 6.71-3.561-3.56 6.71-6.711Zm-1.318 15.837-.776-3.873 4.14-4.14v4.639l-3.364 3.374Z" clip-rule="evenodd"/><path d="M9.318 18.345a.972.972 0 0 0-1.86-.561c-.482 1.435-1.687 2.204-2.934 2.619a8.22 8.22 0 0 1-1.23.302c.062-.365.157-.79.303-1.229.415-1.247 1.184-2.452 2.62-2.935a.971.971 0 1 0-.62-1.842c-.12.04-.236.084-.35.13-2.02.828-3.012 2.588-3.493 4.033a10.383 10.383 0 0 0-.51 2.845l-.001.016v.063c0 .536.434.972.97.972H2.24a7.21 7.21 0 0 0 .878-.065c.527-.063 1.248-.19 2.02-.447 1.445-.48 3.205-1.472 4.033-3.494a5.828 5.828 0 0 0 .147-.407Z"/></svg>Tout reste en Suisse quand c'est possible</p><div class="starlight-aside__content"><p>Le site est servi par Host. Les questions des visiteurs sont gardées 90 jours au plus. Voir <a href="/explications/donnees/">Données et confidentialité</a>.</p></div></aside></div><hgdc-feedback class="hgdc-feedback not-content astro-2pl224dp" data-endpoint="https://docs.hgdc.ch/api/v1/feedback" data-project="jn7dj6vzkgs7n2d16kqjtb99yd8gbdw0" data-pagefind-ignore="true"><div data-step="ask" class="astro-2pl224dp"><p class="hgdc-feedback__question astro-2pl224dp">Cette page t'a aidé ?</p><div class="hgdc-feedback__choices astro-2pl224dp"><button type="button" data-helpful="true" class="astro-2pl224dp">Oui</button><button type="button" data-helpful="false" class="astro-2pl224dp">Non</button></div></div><form data-step="comment" hidden class="astro-2pl224dp"><label for="hgdc-feedback-comment" class="astro-2pl224dp">Qu'est-ce qui manquait ou pourrait être plus clair ? (facultatif)</label><textarea id="hgdc-feedback-comment" name="comment" rows="3" maxlength="1000" class="astro-2pl224dp"></textarea><div class="hgdc-feedback__choices astro-2pl224dp"><button type="submit" class="astro-2pl224dp">Envoyer</button><button type="button" data-skip class="astro-2pl224dp">Passer</button></div></form><p data-step="done" class="hgdc-feedback__done astro-2pl224dp" role="status" hidden>Merci, c'est noté.</p></hgdc-feedback><footer class="sl-flex astro-t4mirzop"><div class="meta sl-flex astro-t4mirzop"></div><div class="pagination-links print:hidden astro-ofihuwrj" dir="ltr"><a href="/demarrer/premiere-doc/" rel="next" class="astro-ofihuwrj"><svg aria-hidden="true" class="astro-ofihuwrj astro-nqfvd567" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1.5rem;"><path d="M17.92 11.62a1.001 1.001 0 0 0-.21-.33l-5-5a1.003 1.003 0 1 0-1.42 1.42l3.3 3.29H7a1 1 0 0 0 0 2h7.59l-3.3 3.29a1.002 1.002 0 0 0 .325 1.639 1 1 0 0 0 1.095-.219l5-5a1 1 0 0 0 .21-.33 1 1 0 0 0 0-.76Z"/></svg><span class="astro-ofihuwrj">Suivant<br class="astro-ofihuwrj"><span class="link-title astro-ofihuwrj">Ta première doc</span></span></a></div></footer><script type="module">var e=class extends HTMLElement{#e=null;connectedCallback(){for(let e of this.querySelectorAll(`[data-helpful]`))e.addEventListener(`click`,()=>this.#n(e.dataset.helpful===`true`));let e=this.querySelector(`form`);e.addEventListener(`submit`,t=>{t.preventDefault();let n=new FormData(e).get(`comment`);this.#r(typeof n==`string`?n.trim():``)}),this.querySelector(`[data-skip]`)?.addEventListener(`click`,()=>void this.#r(``))}#t(e){for(let t of this.querySelectorAll(`[data-step]`))t.hidden=t.dataset.step!==e;e===`comment`&&this.querySelector(`textarea`)?.focus()}#n(e){this.#e=e,e?this.#r(``):this.#t(`comment`)}async#r(e){if(this.#e!==null){try{await fetch(this.dataset.endpoint,{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({project:this.dataset.project,page:location.pathname,helpful:this.#e,...e?{comment:e}:{}}),keepalive:!0})}catch{}this.#t(`done`)}}};customElements.define(`hgdc-feedback`,e);</script></div></div></main></div></div></div></div><hgdc-assistant data-endpoint="https://docs.hgdc.ch/api/v1/ask" data-project="jn7dj6vzkgs7n2d16kqjtb99yd8gbdw0" data-name="Docs"><button type="button" class="hgdc-launcher" data-open aria-haspopup="dialog" aria-expanded="false"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9z" fill="currentColor"></path><path d="M18.5 15l.8 1.9 1.9.8-1.9.8-.8 1.9-.8-1.9-1.9-.8 1.9-.8z" fill="currentColor"></path></svg><span>Demander à l'IA</span><kbd class="hgdc-kbd" data-shortcut aria-hidden="true">Ctrl I</kbd></button><section class="hgdc-panel" role="dialog" aria-modal="false" aria-labelledby="hgdc-assistant-title" hidden><header class="hgdc-panel__header"><div><h2 id="hgdc-assistant-title">Assistant</h2><p>Répond à partir de cette documentation, avec ses sources.</p></div><div class="hgdc-panel__tools"><button type="button" class="hgdc-icon-button" data-reset aria-label="Nouvelle conversation" hidden><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M4 12a8 8 0 1 0 2.3-5.7M4 4v4h4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path></svg></button><button type="button" class="hgdc-icon-button" data-close aria-label="Fermer l'assistant"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M6 6l12 12M18 6 6 18" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></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="Comment publier ma doc ?" required></textarea><button type="submit" class="hgdc-send" data-send aria-label="Envoyer la question"><svg aria-hidden="true" viewBox="0 0 24 24" width="18" height="18"><path d="M12 19V5M5 12l7-7 7 7" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"></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.DWgmlr85.js"></script></body></html>
|
package/template/.build/index.md
CHANGED
|
@@ -2,21 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
Docs transforme un dossier de pages MDX en site de documentation. Tu écris dans ton dépôt Git, Host publie le site à chaque push, et la console `docs.hgdc.ch` branche un assistant qui répond à tes visiteurs à partir de ta doc, et de rien d’autre.
|
|
4
4
|
|
|
5
|
-
[Ta première doc](/
|
|
5
|
+
[Ta première doc](/demarrer/premiere-doc/)
|
|
6
6
|
|
|
7
|
-
[Un dossier, un fichier `docs.json` et une page : ton site tourne en local en cinq minutes.](/
|
|
7
|
+
[Un dossier, un fichier `docs.json` et une page : ton site tourne en local en cinq minutes.](/demarrer/premiere-doc/)
|
|
8
8
|
|
|
9
|
-
[Publier avec Host](/
|
|
9
|
+
[Publier avec Host](/guides/publier/)
|
|
10
10
|
|
|
11
|
-
[Relie le dépôt à Host : chaque push met le site à jour.](/
|
|
11
|
+
[Relie le dépôt à Host : chaque push met le site à jour.](/guides/publier/)
|
|
12
12
|
|
|
13
|
-
[L'assistant IA](/
|
|
13
|
+
[L'assistant IA](/guides/assistant/)
|
|
14
14
|
|
|
15
|
-
[Il répond aux questions de tes visiteurs et cite les pages qu’il a utilisées.](/
|
|
15
|
+
[Il répond aux questions de tes visiteurs et cite les pages qu’il a utilisées.](/guides/assistant/)
|
|
16
16
|
|
|
17
|
-
[Pour les agents](/
|
|
17
|
+
[Pour les agents](/guides/agents/)
|
|
18
18
|
|
|
19
|
-
[`llms.txt`, une version Markdown de chaque page et un serveur MCP en lecture.](/
|
|
19
|
+
[`llms.txt`, une version Markdown de chaque page et un serveur MCP en lecture.](/guides/agents/)
|
|
20
20
|
|
|
21
21
|
## Ce que tu obtiens
|
|
22
22
|
|
|
@@ -32,4 +32,4 @@ Le fichier `docs.json` reprend celui de Mintlify : nom, couleurs, logo, navigati
|
|
|
32
32
|
|
|
33
33
|
> **Tout reste en Suisse quand c'est possible**
|
|
34
34
|
>
|
|
35
|
-
> Le site est servi par Host. Les questions des visiteurs sont gardées 90 jours au plus. Voir [Données et confidentialité](/
|
|
35
|
+
> Le site est servi par Host. Les questions des visiteurs sont gardées 90 jours au plus. Voir [Données et confidentialité](/explications/donnees/).
|
|
@@ -4,27 +4,27 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
Source : /
|
|
7
|
+
Source : /
|
|
8
8
|
|
|
9
9
|
# Bienvenue dans Docs
|
|
10
10
|
|
|
11
11
|
Docs transforme un dossier de pages MDX en site de documentation. Tu écris dans ton dépôt Git, Host publie le site à chaque push, et la console `docs.hgdc.ch` branche un assistant qui répond à tes visiteurs à partir de ta doc, et de rien d’autre.
|
|
12
12
|
|
|
13
|
-
[Ta première doc](/
|
|
13
|
+
[Ta première doc](/demarrer/premiere-doc/)
|
|
14
14
|
|
|
15
|
-
[Un dossier, un fichier `docs.json` et une page : ton site tourne en local en cinq minutes.](/
|
|
15
|
+
[Un dossier, un fichier `docs.json` et une page : ton site tourne en local en cinq minutes.](/demarrer/premiere-doc/)
|
|
16
16
|
|
|
17
|
-
[Publier avec Host](/
|
|
17
|
+
[Publier avec Host](/guides/publier/)
|
|
18
18
|
|
|
19
|
-
[Relie le dépôt à Host : chaque push met le site à jour.](/
|
|
19
|
+
[Relie le dépôt à Host : chaque push met le site à jour.](/guides/publier/)
|
|
20
20
|
|
|
21
|
-
[L'assistant IA](/
|
|
21
|
+
[L'assistant IA](/guides/assistant/)
|
|
22
22
|
|
|
23
|
-
[Il répond aux questions de tes visiteurs et cite les pages qu’il a utilisées.](/
|
|
23
|
+
[Il répond aux questions de tes visiteurs et cite les pages qu’il a utilisées.](/guides/assistant/)
|
|
24
24
|
|
|
25
|
-
[Pour les agents](/
|
|
25
|
+
[Pour les agents](/guides/agents/)
|
|
26
26
|
|
|
27
|
-
[`llms.txt`, une version Markdown de chaque page et un serveur MCP en lecture.](/
|
|
27
|
+
[`llms.txt`, une version Markdown de chaque page et un serveur MCP en lecture.](/guides/agents/)
|
|
28
28
|
|
|
29
29
|
## Ce que tu obtiens
|
|
30
30
|
|
|
@@ -40,11 +40,11 @@ Le fichier `docs.json` reprend celui de Mintlify : nom, couleurs, logo, navigati
|
|
|
40
40
|
|
|
41
41
|
> **Tout reste en Suisse quand c'est possible**
|
|
42
42
|
>
|
|
43
|
-
> Le site est servi par Host. Les questions des visiteurs sont gardées 90 jours au plus. Voir [Données et confidentialité](/
|
|
43
|
+
> Le site est servi par Host. Les questions des visiteurs sont gardées 90 jours au plus. Voir [Données et confidentialité](/explications/donnees/).
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
47
|
-
Source : /
|
|
47
|
+
Source : /demarrer/premiere-doc/
|
|
48
48
|
|
|
49
49
|
# Ta première doc en cinq minutes
|
|
50
50
|
|
|
@@ -108,13 +108,13 @@ Il te faut Node.js 22 ou plus récent, ou Bun. Tout le reste s’installe avec l
|
|
|
108
108
|
|
|
109
109
|
## Et ensuite
|
|
110
110
|
|
|
111
|
-
- [Publier avec Host](/
|
|
112
|
-
- [Écrire en MDX](/
|
|
113
|
-
- [docs.json](/
|
|
111
|
+
- [Publier avec Host](/guides/publier/) pour mettre le site en ligne.
|
|
112
|
+
- [Écrire en MDX](/guides/ecrire/) pour les titres, les liens, les images et le code.
|
|
113
|
+
- [docs.json](/reference/docs-json/) pour toutes les options.
|
|
114
114
|
|
|
115
115
|
---
|
|
116
116
|
|
|
117
|
-
Source : /
|
|
117
|
+
Source : /guides/publier/
|
|
118
118
|
|
|
119
119
|
# Publier avec Host
|
|
120
120
|
|
|
@@ -150,7 +150,7 @@ Host construit ton site à chaque push et le sert depuis son serveur. La console
|
|
|
150
150
|
|
|
151
151
|
> **Note**
|
|
152
152
|
>
|
|
153
|
-
> Le projet apparaît dans la console dès que tu t’y connectes avec ton compte
|
|
153
|
+
> Le projet apparaît dans la console dès que tu t’y connectes avec ton compte HGDC. Ses réglages (domaines, assistant) s’y changent comme pour n’importe quel projet.
|
|
154
154
|
|
|
155
155
|
## Ton domaine
|
|
156
156
|
|
|
@@ -184,7 +184,7 @@ Le dossier `dist/` est un site statique, il se dépose chez n’importe quel hé
|
|
|
184
184
|
|
|
185
185
|
---
|
|
186
186
|
|
|
187
|
-
Source : /
|
|
187
|
+
Source : /guides/ecrire/
|
|
188
188
|
|
|
189
189
|
# Écrire en MDX
|
|
190
190
|
|
|
@@ -252,7 +252,7 @@ Les fichiers qui commencent par `_` (comme `_brouillon.mdx`), `README.md`, `CHAN
|
|
|
252
252
|
|
|
253
253
|
---
|
|
254
254
|
|
|
255
|
-
Source : /
|
|
255
|
+
Source : /guides/composants/
|
|
256
256
|
|
|
257
257
|
# Composants
|
|
258
258
|
|
|
@@ -304,9 +304,9 @@ Ces composants s’utilisent directement dans une page `.mdx`, sans `import`. Il
|
|
|
304
304
|
|
|
305
305
|
## Cartes
|
|
306
306
|
|
|
307
|
-
[Avec un lien](/
|
|
307
|
+
[Avec un lien](/guides/publier/)
|
|
308
308
|
|
|
309
|
-
[Toute la carte est cliquable.](/
|
|
309
|
+
[Toute la carte est cliquable.](/guides/publier/)
|
|
310
310
|
|
|
311
311
|
Sans lien
|
|
312
312
|
|
|
@@ -314,9 +314,7 @@ Pour présenter une idée.
|
|
|
314
314
|
|
|
315
315
|
```mdx
|
|
316
316
|
<CardGroup cols={2}>
|
|
317
|
-
<Card title="Avec un lien" href="/guides/publier/">
|
|
318
|
-
Toute la carte est cliquable.
|
|
319
|
-
</Card>
|
|
317
|
+
<Card title="Avec un lien" href="/guides/publier/">Toute la carte est cliquable.</Card>
|
|
320
318
|
<Card title="Sans lien">Pour présenter une idée.</Card>
|
|
321
319
|
</CardGroup>
|
|
322
320
|
```
|
|
@@ -325,9 +323,13 @@ Pour présenter une idée.
|
|
|
325
323
|
|
|
326
324
|
## Onglets
|
|
327
325
|
|
|
328
|
-
|
|
326
|
+
```bash
|
|
327
|
+
npm install --save-dev @hgdc/docs
|
|
328
|
+
```
|
|
329
329
|
|
|
330
|
-
|
|
330
|
+
```bash
|
|
331
|
+
bun add --dev @hgdc/docs
|
|
332
|
+
```
|
|
331
333
|
|
|
332
334
|
```mdx
|
|
333
335
|
<Tabs>
|
|
@@ -338,7 +340,7 @@ Pour présenter une idée.
|
|
|
338
340
|
|
|
339
341
|
## Accordéons
|
|
340
342
|
|
|
341
|
-
Faut-il un compte
|
|
343
|
+
Faut-il un compte HGDC pour écrire ?
|
|
342
344
|
|
|
343
345
|
Non. Le site se construit sans compte. Le compte sert à la console : publication suivie et assistant.
|
|
344
346
|
|
|
@@ -358,7 +360,7 @@ Chaque composant a une forme Markdown : un encadré devient une citation qui com
|
|
|
358
360
|
|
|
359
361
|
---
|
|
360
362
|
|
|
361
|
-
Source : /
|
|
363
|
+
Source : /guides/navigation/
|
|
362
364
|
|
|
363
365
|
# Navigation, onglets et versions
|
|
364
366
|
|
|
@@ -426,7 +428,7 @@ En bas de chaque page, les liens Précédent et Suivant suivent l’ordre de la
|
|
|
426
428
|
|
|
427
429
|
---
|
|
428
430
|
|
|
429
|
-
Source : /
|
|
431
|
+
Source : /guides/theme/
|
|
430
432
|
|
|
431
433
|
# Thème et logo
|
|
432
434
|
|
|
@@ -464,7 +466,7 @@ Sans favicon, le site n’en annonce pas d’autre que `/favicon.svg` s’il exi
|
|
|
464
466
|
|
|
465
467
|
---
|
|
466
468
|
|
|
467
|
-
Source : /
|
|
469
|
+
Source : /guides/assistant/
|
|
468
470
|
|
|
469
471
|
# L'assistant IA
|
|
470
472
|
|
|
@@ -515,7 +517,7 @@ Au-dessus du journal, cherche une question par ses mots, ou filtre par état : *
|
|
|
515
517
|
|
|
516
518
|
---
|
|
517
519
|
|
|
518
|
-
Source : /
|
|
520
|
+
Source : /guides/agents/
|
|
519
521
|
|
|
520
522
|
# llms.txt et MCP
|
|
521
523
|
|
|
@@ -570,11 +572,11 @@ Le serveur propose trois outils :
|
|
|
570
572
|
| `get_page` | Rend une page complète en Markdown, à partir de son chemin. |
|
|
571
573
|
| `list_pages` | Liste les pages avec leur titre et leur chemin. |
|
|
572
574
|
|
|
573
|
-
Le détail du protocole est dans la [référence MCP](/
|
|
575
|
+
Le détail du protocole est dans la [référence MCP](/reference/mcp/).
|
|
574
576
|
|
|
575
577
|
---
|
|
576
578
|
|
|
577
|
-
Source : /
|
|
579
|
+
Source : /reference/docs-json/
|
|
578
580
|
|
|
579
581
|
# docs.json
|
|
580
582
|
|
|
@@ -582,20 +584,24 @@ Source : /docs/reference/docs-json/
|
|
|
582
584
|
|
|
583
585
|
## Champs
|
|
584
586
|
|
|
585
|
-
| Champ | Type
|
|
586
|
-
| -------------------- |
|
|
587
|
-
| `name` | texte
|
|
588
|
-
| `description` | texte
|
|
589
|
-
| `navigation` | objet
|
|
590
|
-
| `project` | texte
|
|
591
|
-
| `language` | `fr`, `en`, `de`, `it`
|
|
592
|
-
| `
|
|
593
|
-
| `colors.
|
|
594
|
-
| `
|
|
595
|
-
| `
|
|
596
|
-
| `
|
|
597
|
-
| `
|
|
598
|
-
| `
|
|
587
|
+
| Champ | Type | Obligatoire | Rôle |
|
|
588
|
+
| -------------------- | --------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
589
|
+
| `name` | texte | oui | Nom de la doc, en tête du site et dans `llms.txt`. 80 caractères au plus. |
|
|
590
|
+
| `description` | texte | non | Une phrase de présentation. |
|
|
591
|
+
| `navigation` | objet | oui | Pages, groupes, onglets ou versions. Voir [Navigation](/guides/navigation/). |
|
|
592
|
+
| `project` | texte | non | Identifiant du projet dans la console. Active l’assistant et l’indexation. |
|
|
593
|
+
| `language` | `fr`, `en`, `de`, `it` | non | Langue de l’interface du site. `fr` par défaut. |
|
|
594
|
+
| `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. |
|
|
595
|
+
| `colors.primary` | couleur `#rrggbb` | non | Couleur des liens et des éléments actifs. |
|
|
596
|
+
| `colors.dark` | couleur `#rrggbb` | non | La même, en mode sombre. |
|
|
597
|
+
| `logo` | chemin, ou `{ light, dark }` | non | Logo affiché en tête. |
|
|
598
|
+
| `favicon` | chemin | non | Icône de l’onglet du navigateur. |
|
|
599
|
+
| `navbar.links` | liste de `{ label, href }` | non | Jusqu’à 5 liens dans la barre du haut (adresses complètes). |
|
|
600
|
+
| `navbar.primary` | `{ label, href }` | non | Bouton mis en avant à droite de la barre du haut. |
|
|
601
|
+
| `footer.socials` | objet | non | Liens vers tes réseaux : `linkedin`, `github`, `gitlab`, `x`, `youtube`, `instagram`, `facebook`, `discord`, `mastodon`, `bluesky`, `website`. |
|
|
602
|
+
| `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. |
|
|
603
|
+
| `assistant.enabled` | oui / non | non | `false` cache l’assistant du site. |
|
|
604
|
+
| `assistant.endpoint` | adresse | non | API de l’assistant, à ne changer que pour un environnement de test. |
|
|
599
605
|
|
|
600
606
|
## Navigation
|
|
601
607
|
|
|
@@ -622,7 +628,7 @@ docs.json invalide :
|
|
|
622
628
|
|
|
623
629
|
---
|
|
624
630
|
|
|
625
|
-
Source : /
|
|
631
|
+
Source : /reference/cli/
|
|
626
632
|
|
|
627
633
|
# La commande hgdc-docs
|
|
628
634
|
|
|
@@ -658,7 +664,7 @@ Options : `--port 4000` change le port de `dev` et `preview`, `--help` affiche l
|
|
|
658
664
|
|
|
659
665
|
---
|
|
660
666
|
|
|
661
|
-
Source : /
|
|
667
|
+
Source : /reference/api-assistant/
|
|
662
668
|
|
|
663
669
|
# API de l'assistant
|
|
664
670
|
|
|
@@ -698,18 +704,8 @@ L’en-tête `Origin` doit être l’adresse du site ou un des domaines déclar
|
|
|
698
704
|
"status": "answered",
|
|
699
705
|
"answer": "Importe le dépôt dans Host[^1], puis synchronise le projet dans la console[^2].",
|
|
700
706
|
"sources": [
|
|
701
|
-
{
|
|
702
|
-
|
|
703
|
-
"title": "Publier avec Host",
|
|
704
|
-
"section": "Avec Host",
|
|
705
|
-
"url": "https://docs.acme.ch/guides/publier/#avec-host"
|
|
706
|
-
},
|
|
707
|
-
{
|
|
708
|
-
"n": 2,
|
|
709
|
-
"title": "Publier avec Host",
|
|
710
|
-
"section": "Relier la console",
|
|
711
|
-
"url": "https://docs.acme.ch/guides/publier/#relier-la-console"
|
|
712
|
-
}
|
|
707
|
+
{ "n": 1, "title": "Publier avec Host", "section": "Avec Host", "url": "https://docs.acme.ch/guides/publier/#avec-host" },
|
|
708
|
+
{ "n": 2, "title": "Publier avec Host", "section": "Relier la console", "url": "https://docs.acme.ch/guides/publier/#relier-la-console" }
|
|
713
709
|
]
|
|
714
710
|
}
|
|
715
711
|
```
|
|
@@ -733,7 +729,7 @@ Chaque erreur porte aussi `error.message`, une phrase en français à montrer te
|
|
|
733
729
|
|
|
734
730
|
---
|
|
735
731
|
|
|
736
|
-
Source : /
|
|
732
|
+
Source : /reference/mcp/
|
|
737
733
|
|
|
738
734
|
# Serveur MCP
|
|
739
735
|
|
|
@@ -787,7 +783,7 @@ Le serveur est public et en lecture seule : il ne donne accès qu’à ce que le
|
|
|
787
783
|
|
|
788
784
|
---
|
|
789
785
|
|
|
790
|
-
Source : /
|
|
786
|
+
Source : /explications/fonctionnement/
|
|
791
787
|
|
|
792
788
|
# Comment ça marche
|
|
793
789
|
|
|
@@ -824,7 +820,7 @@ Une question passe par deux recherches : par mots (les termes exacts, comme `doc
|
|
|
824
820
|
|
|
825
821
|
---
|
|
826
822
|
|
|
827
|
-
Source : /
|
|
823
|
+
Source : /explications/donnees/
|
|
828
824
|
|
|
829
825
|
# Données et confidentialité
|
|
830
826
|
|