@hgdc/docs 0.1.0 → 0.2.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 +4 -0
- package/package.json +3 -2
- package/src/build/base-links.ts +35 -0
- package/src/build/outputs.ts +17 -4
- package/src/core/config.ts +8 -0
- package/src/core/llms.ts +8 -5
- package/src/core/navigation.ts +24 -0
- package/src/integration.ts +42 -6
- package/src/overrides/Head.astro +14 -12
- package/src/overrides/PageTitle.astro +95 -94
- package/src/overrides/Sidebar.astro +60 -60
- package/template/.astro/content-modules.mjs +15 -15
- package/template/.build/.well-known/llms.txt +17 -17
- package/template/.build/404.html +5 -5
- package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.Cn3-p701.js +1 -0
- package/template/.build/_astro/common.C-MpX45O.css +3 -0
- package/template/.build/_astro/{ui-core.Clh5jUUO.js → ui-core.CrG20ya_.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 +11 -11
- package/template/.build/explications/donnees.md +1 -1
- package/template/.build/explications/fonctionnement/index.html +13 -12
- package/template/.build/explications/fonctionnement.md +3 -3
- package/template/.build/guides/agents/index.html +16 -11
- package/template/.build/guides/agents.md +16 -2
- package/template/.build/guides/assistant/index.html +14 -12
- package/template/.build/guides/assistant.md +5 -1
- package/template/.build/guides/composants/index.html +19 -19
- package/template/.build/guides/composants.md +8 -10
- package/template/.build/guides/ecrire/index.html +13 -12
- package/template/.build/guides/ecrire.md +1 -1
- package/template/.build/guides/navigation/index.html +13 -12
- package/template/.build/guides/publier/index.html +26 -17
- package/template/.build/guides/publier.md +9 -9
- package/template/.build/guides/theme/index.html +13 -12
- package/template/.build/guides/theme.md +1 -1
- package/template/.build/index.html +12 -11
- package/template/.build/index.md +11 -11
- package/template/.build/llms-full.txt +95 -69
- package/template/.build/llms.txt +17 -17
- package/template/.build/pagefind/fragment/fr-ch_2a431a9.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_456586a.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_68e734b.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_72b91f4.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_8f256dd.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_95a15cc.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_aa80c55.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_ab79738.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_cfa4336.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_dab8f5e.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_de60b43.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-entry.json +1 -1
- package/template/.build/pagefind/pagefind.fr-ch_2f3ea8fccf961.pf_meta +0 -0
- package/template/.build/reference/api-assistant/index.html +12 -12
- package/template/.build/reference/api-assistant.md +13 -3
- package/template/.build/reference/cli/index.html +11 -11
- package/template/.build/reference/cli.md +5 -5
- package/template/.build/reference/docs-json/index.html +11 -11
- package/template/.build/reference/docs-json.md +2 -2
- package/template/.build/reference/mcp/index.html +11 -11
- package/template/node_modules/.vite/deps/_metadata.json +8 -8
- package/src/build/public-files.test.ts +0 -29
- package/src/core/core.test.ts +0 -253
- package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.g9hoxVJg.js +0 -1
- package/template/.build/_astro/common.8GHCkW7i.css +0 -3
- package/template/.build/pagefind/fragment/fr-ch_148313b.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_424fd16.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_5a4d77d.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_6c36edc.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_73d7887.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_8234ed3.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_8f8a19e.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_9f1b981.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_a19039d.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_d72cc1e.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_d732215.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_e78d58b.pf_fragment +0 -0
- package/template/.build/pagefind/fragment/fr-ch_e92f972.pf_fragment +0 -0
- package/template/.build/pagefind/index/fr-ch_f94c95d.pf_index +0 -0
- package/template/.build/pagefind/pagefind.fr-ch_fb78ab42961f4.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-lavvtzy4"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>docs.json | 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="/docs/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="/docs/reference/docs-json.md"><link rel="describedby" type="text/markdown" href="/docs/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="/_astro/page.cNngjUgL.js"></script><style>@layer starlight.components{starlight-tabs:where(.astro-
|
|
29
|
-
</style></head><body class="astro-
|
|
27
|
+
</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-sni56jbe" 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-sni56jbe" 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-sni56jbe" 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="/docs/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/docs/_astro/common.C-MpX45O.css"><style>@layer starlight.components{svg:where(.astro-sni56jbe){color:var(--sl-icon-color);font-size:var(--sl-icon-size,1em);width:1em;height:1em;overflow:visible}}
|
|
28
|
+
</style><script type="module" src="/docs/_astro/page.cNngjUgL.js"></script><style>@layer starlight.components{starlight-tabs:where(.astro-4p5i55ez){display:block}.tablist-wrapper:where(.astro-4p5i55ez){overflow-x:auto}:where(.astro-4p5i55ez)[role=tablist]{border-bottom:2px solid var(--sl-color-gray-5);padding:0;list-style:none;display:flex}.tab:where(.astro-4p5i55ez){display:flex}.tab:where(.astro-4p5i55ez)>:where(.astro-4p5i55ez)[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-4p5i55ez) :where(.astro-4p5i55ez)[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-4p5i55ez)~[role=tabpanel]{margin-top:1rem}}
|
|
29
|
+
</style></head><body class="astro-lavvtzy4"><a class="sl-skip-link astro-7n5v7vyb" href="#_top">Aller au contenu</a><div class="page sl-flex astro-fr34orpz"><header class="header astro-fr34orpz"><div class="header astro-5krb3hnw"><div class="title-wrapper sl-flex astro-5krb3hnw"><a href="/docs/" class="site-title sl-flex astro-7hgfqris"><img class="light:sl-hidden print:hidden astro-7hgfqris" alt src="/docs/_astro/logo-sombre.BkgsFXxh.svg" width="32" height="32"><img class="dark:sl-hidden print:block astro-7hgfqris" alt src="/docs/_astro/logo-clair.BqNh6JNi.svg" width="32" height="32"><span class="astro-7hgfqris" translate="no">Docs</span></a></div><div class="sl-flex print:hidden astro-5krb3hnw"><site-search class="astro-5krb3hnw astro-w6spbfx5" data-translations="{"placeholder":"Rechercher"}"><button data-open-modal disabled aria-label="Rechercher" aria-keyshortcuts="Control+K" class="astro-w6spbfx5"><svg aria-hidden="true" class="astro-w6spbfx5 astro-sni56jbe" 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-w6spbfx5" aria-hidden="true">Rechercher</span><kbd class="sl-hidden md:sl-flex astro-w6spbfx5" style="display: none;"><kbd class="astro-w6spbfx5">Ctrl</kbd><kbd class="astro-w6spbfx5">K</kbd></kbd></button><dialog style="padding:0" aria-label="Rechercher" class="astro-w6spbfx5"><div class="dialog-frame sl-flex astro-w6spbfx5"><button data-close-modal class="sl-flex md:sl-hidden astro-w6spbfx5">Annuler</button><div class="search-container astro-w6spbfx5"><div id="starlight__search" class="astro-w6spbfx5"></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="/_astro/Search.astro_astro_type_script_index_0_lang.
|
|
41
|
+
</script><script type="module" src="/docs/_astro/Search.astro_astro_type_script_index_0_lang.Cn3-p701.js"></script></div><div class="sl-hidden md:sl-flex print:hidden right-group astro-5krb3hnw"><div class="sl-flex social-icons astro-5krb3hnw"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-jnsxwl6p"><span class="sr-only astro-jnsxwl6p">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-jnsxwl6p astro-sni56jbe" 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-jnsxwl6p"><option value="dark" class="astro-jnsxwl6p">Sombre</option><option value="light" class="astro-jnsxwl6p">Clair</option><option value="auto" selected class="astro-jnsxwl6p">Auto</option></select><svg aria-hidden="true" class="icon caret astro-jnsxwl6p astro-sni56jbe" 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-fr34orpz" aria-label="principale"><button popovertarget="starlight__sidebar" class="sl-menu-button sl-flex md:sl-hidden print:hidden astro-nyhgrkmo"><svg aria-hidden="true" class="open-menu astro-nyhgrkmo astro-sni56jbe" 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-nyhgrkmo astro-sni56jbe" 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-nyhgrkmo">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-fr34orpz"><div class="sidebar-content sl-flex astro-fr34orpz"><div class="hgdc-sections"><nav aria-label="Sections de la documentation"><ul class="hgdc-tabs"><li><a href="/docs/">Guides</a></li><li><a href="/docs/reference/docs-json/" aria-current="page">Référence</a></li><li><a href="/docs/explications/fonctionnement/">Explications</a></li></ul></nav></div><sl-sidebar-state-persist data-hash="17fpf6a" class="astro-lm6od3dj"><script aria-hidden="true">
|
|
44
44
|
(() => {
|
|
45
45
|
try {
|
|
46
46
|
if (!matchMedia('(min-width: 50em)').matches) return;
|
|
@@ -63,16 +63,16 @@
|
|
|
63
63
|
);
|
|
64
64
|
} catch {}
|
|
65
65
|
})();
|
|
66
|
-
</script><ul class="top-level astro-
|
|
66
|
+
</script><ul class="top-level astro-uov4p2fy"><li class="astro-uov4p2fy"><details open class="astro-uov4p2fy"><summary class="astro-uov4p2fy"><span class="group-label astro-uov4p2fy"><span class="large astro-uov4p2fy">Configuration</span></span><svg aria-hidden="true" class="caret astro-uov4p2fy astro-sni56jbe" 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-uov4p2fy"><li class="astro-uov4p2fy"><a href="/docs/reference/docs-json/" aria-current="page" class="astro-uov4p2fy"><span class="astro-uov4p2fy">docs.json</span></a></li><li class="astro-uov4p2fy"><a href="/docs/reference/cli/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">Commande hgdc-docs</span></a></li></ul></details></li><li class="astro-uov4p2fy"><details open class="astro-uov4p2fy"><summary class="astro-uov4p2fy"><span class="group-label astro-uov4p2fy"><span class="large astro-uov4p2fy">API</span></span><svg aria-hidden="true" class="caret astro-uov4p2fy astro-sni56jbe" 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-uov4p2fy"><li class="astro-uov4p2fy"><a href="/docs/reference/api-assistant/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">API de l'assistant</span></a></li><li class="astro-uov4p2fy"><a href="/docs/reference/mcp/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">Serveur MCP</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-2rk3g7w4"><div class="social-icons astro-2rk3g7w4"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-jnsxwl6p"><span class="sr-only astro-jnsxwl6p">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-jnsxwl6p astro-sni56jbe" 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-jnsxwl6p"><option value="dark" class="astro-jnsxwl6p">Sombre</option><option value="light" class="astro-jnsxwl6p">Clair</option><option value="auto" selected class="astro-jnsxwl6p">Auto</option></select><svg aria-hidden="true" class="icon caret astro-jnsxwl6p astro-sni56jbe" 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-
|
|
75
|
+
</script></div></div></div></sl-sidebar-pane></nav><div class="main-frame astro-fr34orpz"><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-o3fus7d3"><aside class="right-sidebar-container print:hidden astro-o3fus7d3"><div class="right-sidebar astro-o3fus7d3"><div class="lg:sl-hidden astro-uw7nsgmq"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-kp2z5vdj"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-kp2z5vdj"><details id="starlight__mobile-toc" class="astro-kp2z5vdj"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-kp2z5vdj"><span class="toggle sl-flex astro-kp2z5vdj">Sur cette page<svg aria-hidden="true" class="caret astro-kp2z5vdj astro-sni56jbe" 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-kp2z5vdj"></span></summary><div class="dropdown astro-kp2z5vdj"><ul class="isMobile astro-5tbupws2" style="--depth: 0;"><li style="--depth: 0;" class="astro-5tbupws2"><a href="#_top" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#champs" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Champs</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#navigation" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Navigation</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#erreurs" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Erreurs</span></a></li></ul></div></details></nav></mobile-starlight-toc><script type="module" src="/docs/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.C3fM4Kra.js"></script></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-uw7nsgmq"><div class="sl-container astro-uw7nsgmq"><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-5tbupws2" style="--depth: 0;"><li style="--depth: 0;" class="astro-5tbupws2"><a href="#_top" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#champs" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Champs</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#navigation" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Navigation</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#erreurs" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Erreurs</span></a></li></ul></nav></starlight-toc><script type="module" src="/docs/_astro/TableOfContents.astro_astro_type_script_index_0_lang.BpJaGz7G.js"></script></div></div></div></aside><div class="main-pane astro-o3fus7d3"><main data-pagefind-body class="astro-lavvtzy4" lang="fr-CH" dir="ltr"><div class="content-panel astro-syzncznl"><div class="sl-container astro-syzncznl"><div class="hgdc-title"><h1 id="_top" class="astro-y7ikkdqz">docs.json</h1><div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore><button type="button" class="hgdc-action" data-hgdc-copy="/docs/reference/docs-json.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="/docs/reference/docs-json.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="/docs/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-syzncznl"><div class="sl-container astro-syzncznl"><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>
|
|
76
76
|
<h2 id="champs">Champs</h2>
|
|
77
77
|
|
|
78
78
|
|
|
@@ -157,7 +157,7 @@
|
|
|
157
157
|
|
|
158
158
|
|
|
159
159
|
|
|
160
|
-
<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>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>footer.socials</code></td><td>objet</td><td>non</td><td>Liens vers tes réseaux : <code>github</code>, <code>gitlab</code>, <code>linkedin</code>, <code>x.com</code>, <code>mastodon</code>, <code>discord</code>, <code>youtube</code>, <code>instagram</code>, <code>bluesky</code>.</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>
|
|
160
|
+
<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="/docs/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>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>footer.socials</code></td><td>objet</td><td>non</td><td>Liens vers tes réseaux : <code>github</code>, <code>gitlab</code>, <code>linkedin</code>, <code>x.com</code>, <code>mastodon</code>, <code>discord</code>, <code>youtube</code>, <code>instagram</code>, <code>bluesky</code>.</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>
|
|
161
161
|
<h2 id="navigation">Navigation</h2>
|
|
162
162
|
<p>Quatre formes, une seule à la fois :</p>
|
|
163
163
|
|
|
@@ -189,4 +189,4 @@
|
|
|
189
189
|
<p>Un groupe accepte <code>expanded: false</code> pour être replié par défaut, et peut contenir des groupes.</p>
|
|
190
190
|
<h2 id="erreurs">Erreurs</h2>
|
|
191
191
|
<p>Un <code>docs.json</code> invalide fait échouer le build avec la liste des problèmes, par exemple :</p>
|
|
192
|
-
<div class="expressive-code"><link rel="stylesheet" href="/_astro/ec.8nqtp.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:#e6edf3;--1:#1f2328">docs.json invalide :</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">- colors.primary : couleur attendue au format #rrggbb</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">- 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><footer class="sl-flex astro-
|
|
192
|
+
<div class="expressive-code"><link rel="stylesheet" href="/docs/_astro/ec.8nqtp.css"><script type="module" src="/docs/_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:#e6edf3;--1:#1f2328">docs.json invalide :</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">- colors.primary : couleur attendue au format #rrggbb</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">- 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><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/reference/cli/" 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">Commande hgdc-docs</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>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# docs.json
|
|
2
2
|
|
|
3
|
-
`docs.json` vit à la racine du dossier de la doc. Il reprend le format de Mintlify : les champs que
|
|
3
|
+
`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"`.
|
|
4
4
|
|
|
5
5
|
## Champs
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
| -------------------- | ---------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
9
9
|
| `name` | texte | oui | Nom de la doc, en tête du site et dans `llms.txt`. 80 caractères au plus. |
|
|
10
10
|
| `description` | texte | non | Une phrase de présentation. |
|
|
11
|
-
| `navigation` | objet | oui | Pages, groupes, onglets ou versions. Voir [Navigation](/guides/navigation/).
|
|
11
|
+
| `navigation` | objet | oui | Pages, groupes, onglets ou versions. Voir [Navigation](/docs/guides/navigation/). |
|
|
12
12
|
| `project` | texte | non | Identifiant du projet dans la console. Active l’assistant et l’indexation. |
|
|
13
13
|
| `language` | `fr`, `en`, `de`, `it` | non | Langue de l’interface du site. `fr` par défaut. |
|
|
14
14
|
| `colors.primary` | couleur `#rrggbb` | non | Couleur des liens et des éléments actifs. |
|
|
@@ -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-lavvtzy4"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>Serveur MCP | 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="/docs/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="Serveur MCP"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Transport, méthodes et outils du serveur MCP en lecture d'un projet."/><meta property="og:site_name" content="Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Transport, méthodes et outils du serveur MCP en lecture d'un projet."/><link rel="alternate" type="text/markdown" href="/docs/reference/mcp.md"><link rel="describedby" type="text/markdown" href="/docs/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="/_astro/page.cNngjUgL.js"></script><style>@layer starlight.components{starlight-tabs:where(.astro-
|
|
29
|
-
</style></head><body class="astro-
|
|
27
|
+
</script><template id="theme-icons"><svg aria-hidden="true" class="light astro-sni56jbe" 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-sni56jbe" 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-sni56jbe" 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="/docs/_astro/print.ehPL0gv-.css" media="print"><link rel="stylesheet" href="/docs/_astro/common.C-MpX45O.css"><style>@layer starlight.components{svg:where(.astro-sni56jbe){color:var(--sl-icon-color);font-size:var(--sl-icon-size,1em);width:1em;height:1em;overflow:visible}}
|
|
28
|
+
</style><script type="module" src="/docs/_astro/page.cNngjUgL.js"></script><style>@layer starlight.components{starlight-tabs:where(.astro-4p5i55ez){display:block}.tablist-wrapper:where(.astro-4p5i55ez){overflow-x:auto}:where(.astro-4p5i55ez)[role=tablist]{border-bottom:2px solid var(--sl-color-gray-5);padding:0;list-style:none;display:flex}.tab:where(.astro-4p5i55ez){display:flex}.tab:where(.astro-4p5i55ez)>:where(.astro-4p5i55ez)[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-4p5i55ez) :where(.astro-4p5i55ez)[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-4p5i55ez)~[role=tabpanel]{margin-top:1rem}}
|
|
29
|
+
</style></head><body class="astro-lavvtzy4"><a class="sl-skip-link astro-7n5v7vyb" href="#_top">Aller au contenu</a><div class="page sl-flex astro-fr34orpz"><header class="header astro-fr34orpz"><div class="header astro-5krb3hnw"><div class="title-wrapper sl-flex astro-5krb3hnw"><a href="/docs/" class="site-title sl-flex astro-7hgfqris"><img class="light:sl-hidden print:hidden astro-7hgfqris" alt src="/docs/_astro/logo-sombre.BkgsFXxh.svg" width="32" height="32"><img class="dark:sl-hidden print:block astro-7hgfqris" alt src="/docs/_astro/logo-clair.BqNh6JNi.svg" width="32" height="32"><span class="astro-7hgfqris" translate="no">Docs</span></a></div><div class="sl-flex print:hidden astro-5krb3hnw"><site-search class="astro-5krb3hnw astro-w6spbfx5" data-translations="{"placeholder":"Rechercher"}"><button data-open-modal disabled aria-label="Rechercher" aria-keyshortcuts="Control+K" class="astro-w6spbfx5"><svg aria-hidden="true" class="astro-w6spbfx5 astro-sni56jbe" 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-w6spbfx5" aria-hidden="true">Rechercher</span><kbd class="sl-hidden md:sl-flex astro-w6spbfx5" style="display: none;"><kbd class="astro-w6spbfx5">Ctrl</kbd><kbd class="astro-w6spbfx5">K</kbd></kbd></button><dialog style="padding:0" aria-label="Rechercher" class="astro-w6spbfx5"><div class="dialog-frame sl-flex astro-w6spbfx5"><button data-close-modal class="sl-flex md:sl-hidden astro-w6spbfx5">Annuler</button><div class="search-container astro-w6spbfx5"><div id="starlight__search" class="astro-w6spbfx5"></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="/_astro/Search.astro_astro_type_script_index_0_lang.
|
|
41
|
+
</script><script type="module" src="/docs/_astro/Search.astro_astro_type_script_index_0_lang.Cn3-p701.js"></script></div><div class="sl-hidden md:sl-flex print:hidden right-group astro-5krb3hnw"><div class="sl-flex social-icons astro-5krb3hnw"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-jnsxwl6p"><span class="sr-only astro-jnsxwl6p">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-jnsxwl6p astro-sni56jbe" 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-jnsxwl6p"><option value="dark" class="astro-jnsxwl6p">Sombre</option><option value="light" class="astro-jnsxwl6p">Clair</option><option value="auto" selected class="astro-jnsxwl6p">Auto</option></select><svg aria-hidden="true" class="icon caret astro-jnsxwl6p astro-sni56jbe" 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-fr34orpz" aria-label="principale"><button popovertarget="starlight__sidebar" class="sl-menu-button sl-flex md:sl-hidden print:hidden astro-nyhgrkmo"><svg aria-hidden="true" class="open-menu astro-nyhgrkmo astro-sni56jbe" 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-nyhgrkmo astro-sni56jbe" 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-nyhgrkmo">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-fr34orpz"><div class="sidebar-content sl-flex astro-fr34orpz"><div class="hgdc-sections"><nav aria-label="Sections de la documentation"><ul class="hgdc-tabs"><li><a href="/docs/">Guides</a></li><li><a href="/docs/reference/docs-json/" aria-current="page">Référence</a></li><li><a href="/docs/explications/fonctionnement/">Explications</a></li></ul></nav></div><sl-sidebar-state-persist data-hash="17fpf6a" class="astro-lm6od3dj"><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-uov4p2fy"><li class="astro-uov4p2fy"><details open class="astro-uov4p2fy"><summary class="astro-uov4p2fy"><span class="group-label astro-uov4p2fy"><span class="large astro-uov4p2fy">Configuration</span></span><svg aria-hidden="true" class="caret astro-uov4p2fy astro-sni56jbe" 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-uov4p2fy"><li class="astro-uov4p2fy"><a href="/docs/reference/docs-json/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">docs.json</span></a></li><li class="astro-uov4p2fy"><a href="/docs/reference/cli/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">Commande hgdc-docs</span></a></li></ul></details></li><li class="astro-uov4p2fy"><details open class="astro-uov4p2fy"><summary class="astro-uov4p2fy"><span class="group-label astro-uov4p2fy"><span class="large astro-uov4p2fy">API</span></span><svg aria-hidden="true" class="caret astro-uov4p2fy astro-sni56jbe" 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-uov4p2fy"><li class="astro-uov4p2fy"><a href="/docs/reference/api-assistant/" class="astro-uov4p2fy"><span class="astro-uov4p2fy">API de l'assistant</span></a></li><li class="astro-uov4p2fy"><a href="/docs/reference/mcp/" aria-current="page" class="astro-uov4p2fy"><span class="astro-uov4p2fy">Serveur MCP</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-2rk3g7w4"><div class="social-icons astro-2rk3g7w4"></div><starlight-theme-select><label style="--sl-select-width: 6.25em" class="astro-jnsxwl6p"><span class="sr-only astro-jnsxwl6p">Selectionner le thème</span><svg aria-hidden="true" class="icon label-icon astro-jnsxwl6p astro-sni56jbe" 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-jnsxwl6p"><option value="dark" class="astro-jnsxwl6p">Sombre</option><option value="light" class="astro-jnsxwl6p">Clair</option><option value="auto" selected class="astro-jnsxwl6p">Auto</option></select><svg aria-hidden="true" class="icon caret astro-jnsxwl6p astro-sni56jbe" 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="expressive-code"><link rel="stylesheet" href="/_astro/ec.8nqtp.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:#e6edf3;--1:#1f2328">POST https://docs.hgdc.ch/mcp/<identifiant du projet></span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">Content-Type: application/json</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">Accept: application/json, text/event-stream</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="POST https://docs.hgdc.ch/mcp/<identifiant du projet>Content-Type: application/jsonAccept: application/json, text/event-stream"><div></div></button></div></figure></div>
|
|
75
|
+
</script></div></div></div></sl-sidebar-pane></nav><div class="main-frame astro-fr34orpz"><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-o3fus7d3"><aside class="right-sidebar-container print:hidden astro-o3fus7d3"><div class="right-sidebar astro-o3fus7d3"><div class="lg:sl-hidden astro-uw7nsgmq"><mobile-starlight-toc data-min-h="2" data-max-h="3" class="astro-kp2z5vdj"><nav aria-labelledby="starlight__on-this-page--mobile" class="astro-kp2z5vdj"><details id="starlight__mobile-toc" class="astro-kp2z5vdj"><summary id="starlight__on-this-page--mobile" class="sl-flex astro-kp2z5vdj"><span class="toggle sl-flex astro-kp2z5vdj">Sur cette page<svg aria-hidden="true" class="caret astro-kp2z5vdj astro-sni56jbe" 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-kp2z5vdj"></span></summary><div class="dropdown astro-kp2z5vdj"><ul class="isMobile astro-5tbupws2" style="--depth: 0;"><li style="--depth: 0;" class="astro-5tbupws2"><a href="#_top" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#méthodes" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Méthodes</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#outils" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Outils</span></a><ul class="isMobile astro-5tbupws2" style="--depth: 1;"><li style="--depth: 1;" class="astro-5tbupws2"><a href="#search_docs" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">search_docs</span></a></li><li style="--depth: 1;" class="astro-5tbupws2"><a href="#get_page" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">get_page</span></a></li><li style="--depth: 1;" class="astro-5tbupws2"><a href="#list_pages" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">list_pages</span></a></li></ul></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#limites" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Limites</span></a></li></ul></div></details></nav></mobile-starlight-toc><script type="module" src="/docs/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.C3fM4Kra.js"></script></div><div class="right-sidebar-panel sl-hidden lg:sl-block astro-uw7nsgmq"><div class="sl-container astro-uw7nsgmq"><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-5tbupws2" style="--depth: 0;"><li style="--depth: 0;" class="astro-5tbupws2"><a href="#_top" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Vue d’ensemble</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#méthodes" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Méthodes</span></a></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#outils" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Outils</span></a><ul class="astro-5tbupws2" style="--depth: 1;"><li style="--depth: 1;" class="astro-5tbupws2"><a href="#search_docs" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">search_docs</span></a></li><li style="--depth: 1;" class="astro-5tbupws2"><a href="#get_page" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">get_page</span></a></li><li style="--depth: 1;" class="astro-5tbupws2"><a href="#list_pages" style="--depth: 1;" class="astro-5tbupws2"><span style="--depth: 1;" class="astro-5tbupws2">list_pages</span></a></li></ul></li><li style="--depth: 0;" class="astro-5tbupws2"><a href="#limites" style="--depth: 0;" class="astro-5tbupws2"><span style="--depth: 0;" class="astro-5tbupws2">Limites</span></a></li></ul></nav></starlight-toc><script type="module" src="/docs/_astro/TableOfContents.astro_astro_type_script_index_0_lang.BpJaGz7G.js"></script></div></div></div></aside><div class="main-pane astro-o3fus7d3"><main data-pagefind-body class="astro-lavvtzy4" lang="fr-CH" dir="ltr"><div class="content-panel astro-syzncznl"><div class="sl-container astro-syzncznl"><div class="hgdc-title"><h1 id="_top" class="astro-y7ikkdqz">Serveur MCP</h1><div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore><button type="button" class="hgdc-action" data-hgdc-copy="/docs/reference/mcp.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="/docs/reference/mcp.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="/docs/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-syzncznl"><div class="sl-container astro-syzncznl"><div class="sl-markdown-content"><p>Le serveur suit le <a href="https://modelcontextprotocol.io">Model Context Protocol</a>, transport Streamable HTTP, sans session : chaque requête est indépendante.</p>
|
|
76
|
+
<div class="expressive-code"><link rel="stylesheet" href="/docs/_astro/ec.8nqtp.css"><script type="module" src="/docs/_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:#e6edf3;--1:#1f2328">POST https://docs.hgdc.ch/mcp/<identifiant du projet></span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">Content-Type: application/json</span></div></div><div class="ec-line"><div class="code"><span style="--0:#e6edf3;--1:#1f2328">Accept: application/json, text/event-stream</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="POST https://docs.hgdc.ch/mcp/<identifiant du projet>Content-Type: application/jsonAccept: application/json, text/event-stream"><div></div></button></div></figure></div>
|
|
77
77
|
<p>Il répond en JSON (<code>application/json</code>), jamais en flux. <code>GET</code> et <code>DELETE</code> répondent 405. Versions du protocole acceptées : <code>2025-11-25</code>, <code>2025-06-18</code>, <code>2025-03-26</code>.</p>
|
|
78
78
|
<h2 id="méthodes">Méthodes</h2>
|
|
79
79
|
|
|
@@ -148,4 +148,4 @@
|
|
|
148
148
|
<h3 id="list_pages">list_pages</h3>
|
|
149
149
|
<p>Sans paramètre. Rend la liste des pages publiées.</p>
|
|
150
150
|
<h2 id="limites">Limites</h2>
|
|
151
|
-
<p>Le serveur est public et en lecture seule : il ne donne accès qu’à ce que le site publie déjà. Chaque projet accepte 300 requêtes par minute, chaque visiteur 60. Au-delà, la réponse est un 429.</p></div><footer class="sl-flex astro-
|
|
151
|
+
<p>Le serveur est public et en lecture seule : il ne donne accès qu’à ce que le site publie déjà. Chaque projet accepte 300 requêtes par minute, chaque visiteur 60. Au-delà, la réponse est un 429.</p></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/reference/api-assistant/" rel="prev" 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 11H9.41l3.3-3.29a1.004 1.004 0 1 0-1.42-1.42l-5 5a1 1 0 0 0-.21.33 1 1 0 0 0 0 .76 1 1 0 0 0 .21.33l5 5a1.002 1.002 0 0 0 1.639-.325 1 1 0 0 0-.219-1.095L9.41 13H17a1 1 0 0 0 0-2Z"/></svg><span class="astro-gf3kf27h">Précédent<br class="astro-gf3kf27h"><span class="link-title astro-gf3kf27h">API de l'assistant</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>
|
|
@@ -1,31 +1,31 @@
|
|
|
1
1
|
{
|
|
2
|
-
"hash": "
|
|
3
|
-
"configHash": "
|
|
4
|
-
"lockfileHash": "
|
|
5
|
-
"browserHash": "
|
|
2
|
+
"hash": "0530e7fc",
|
|
3
|
+
"configHash": "6620a137",
|
|
4
|
+
"lockfileHash": "44a8a15f",
|
|
5
|
+
"browserHash": "cc028108",
|
|
6
6
|
"optimized": {
|
|
7
7
|
"astro > aria-query": {
|
|
8
8
|
"src": "../../../../../../node_modules/aria-query/lib/index.js",
|
|
9
9
|
"file": "astro_n_aria-query.js",
|
|
10
|
-
"fileHash": "
|
|
10
|
+
"fileHash": "d2d7eb09",
|
|
11
11
|
"needsInterop": true
|
|
12
12
|
},
|
|
13
13
|
"astro > axobject-query": {
|
|
14
14
|
"src": "../../../../../../node_modules/axobject-query/lib/index.js",
|
|
15
15
|
"file": "astro_n_axobject-query.js",
|
|
16
|
-
"fileHash": "
|
|
16
|
+
"fileHash": "0416d07e",
|
|
17
17
|
"needsInterop": true
|
|
18
18
|
},
|
|
19
19
|
"astro > html-escaper": {
|
|
20
20
|
"src": "../../../../../../node_modules/html-escaper/esm/index.js",
|
|
21
21
|
"file": "astro_n_html-escaper.js",
|
|
22
|
-
"fileHash": "
|
|
22
|
+
"fileHash": "1392ba72",
|
|
23
23
|
"needsInterop": false
|
|
24
24
|
},
|
|
25
25
|
"astro/runtime/client/dev-toolbar/entrypoint.js": {
|
|
26
26
|
"src": "../../../../../../node_modules/astro/dist/runtime/client/dev-toolbar/entrypoint.js",
|
|
27
27
|
"file": "astro_runtime_client_dev-toolbar_entrypoint__js.js",
|
|
28
|
-
"fileHash": "
|
|
28
|
+
"fileHash": "bf72726c",
|
|
29
29
|
"needsInterop": false
|
|
30
30
|
}
|
|
31
31
|
},
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
// @vitest-environment node
|
|
2
|
-
import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs"
|
|
3
|
-
import { tmpdir } from "node:os"
|
|
4
|
-
import { join } from "node:path"
|
|
5
|
-
|
|
6
|
-
import { describe, expect, it } from "vitest"
|
|
7
|
-
|
|
8
|
-
import { publicFiles } from "./public-files.ts"
|
|
9
|
-
|
|
10
|
-
describe("fichiers publiés", () => {
|
|
11
|
-
it("ne publie que le déclaré, les médias des dossiers d'images et public/", () => {
|
|
12
|
-
const dir = mkdtempSync(join(tmpdir(), "hgdc-docs-"))
|
|
13
|
-
for (const path of [
|
|
14
|
-
"images/a.png",
|
|
15
|
-
"images/notes.txt",
|
|
16
|
-
"logo/l.svg",
|
|
17
|
-
"secret.txt",
|
|
18
|
-
"contrat.pdf",
|
|
19
|
-
"favicon.svg",
|
|
20
|
-
"public/robots.txt",
|
|
21
|
-
"brouillons/x.png",
|
|
22
|
-
]) {
|
|
23
|
-
mkdirSync(join(dir, path, ".."), { recursive: true })
|
|
24
|
-
writeFileSync(join(dir, path), "x")
|
|
25
|
-
}
|
|
26
|
-
const published = publicFiles(dir, ["/favicon.svg", "/../dehors.svg"]).map((file) => file.to.replaceAll("\\", "/"))
|
|
27
|
-
expect(published.sort()).toEqual(["favicon.svg", "images/a.png", "logo/l.svg", "robots.txt"])
|
|
28
|
-
})
|
|
29
|
-
})
|