@hgdc/docs 0.3.0 → 0.4.1

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.
Files changed (230) hide show
  1. package/package.json +1 -1
  2. package/src/build/content.ts +82 -0
  3. package/src/build/markdown.ts +10 -5
  4. package/src/components/Accordion.astro +3 -1
  5. package/src/components/Callout.astro +31 -0
  6. package/src/components/Card.astro +3 -1
  7. package/src/components/Check.astro +2 -3
  8. package/src/components/CodeGroup.astro +9 -1
  9. package/src/components/Danger.astro +2 -3
  10. package/src/components/Info.astro +2 -3
  11. package/src/components/Note.astro +2 -3
  12. package/src/components/Tip.astro +2 -3
  13. package/src/components/Warning.astro +2 -3
  14. package/src/core/feedback-api.ts +17 -7
  15. package/src/core/theme.ts +6 -3
  16. package/src/integration.ts +74 -16
  17. package/src/overrides/Assistant.astro +17 -39
  18. package/src/overrides/Footer.astro +27 -74
  19. package/src/overrides/Header.astro +92 -0
  20. package/src/overrides/Icon.astro +65 -0
  21. package/src/overrides/PageFrame.astro +55 -8
  22. package/src/overrides/PageSidebar.astro +7 -0
  23. package/src/overrides/PageTitle.astro +93 -62
  24. package/src/overrides/Search.astro +54 -0
  25. package/src/overrides/Sidebar.astro +89 -44
  26. package/src/overrides/SidebarList.astro +52 -0
  27. package/src/overrides/SiteFooter.astro +51 -0
  28. package/src/overrides/ThemeProvider.astro +23 -0
  29. package/src/overrides/ThemeToggle.astro +90 -0
  30. package/src/overrides/TwoColumnContent.astro +45 -0
  31. package/src/overrides/sections.ts +29 -0
  32. package/src/styles/theme.css +2137 -511
  33. package/src/widget/client.ts +51 -19
  34. package/src/widget/code.ts +218 -0
  35. package/src/widget/excerpt.ts +5 -0
  36. package/src/widget/search.ts +226 -0
  37. package/template/.astro/collections/docs.schema.json +3 -0
  38. package/template/.astro/content-assets.mjs +1 -4
  39. package/template/.astro/content-modules.mjs +35 -15
  40. package/template/.astro/data-store.json +1 -0
  41. package/template/.astro/settings.json +5 -0
  42. package/template/.build/.well-known/llms.txt +51 -34
  43. package/template/.build/404.html +16 -42
  44. package/template/.build/_astro/Assistant.astro_astro_type_script_index_0_lang.C1pz7yK1.js +4 -0
  45. package/template/.build/_astro/CodeGroup.astro_astro_type_script_index_0_lang.-eM8maAX.js +1 -0
  46. package/template/.build/_astro/Footer.astro_astro_type_script_index_0_lang.DzCnn3OT.js +1 -0
  47. package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.D7EcezBU.js +1 -0
  48. package/template/.build/_astro/code.smqv0zhe.js +9 -0
  49. package/template/.build/_astro/common.Dx3aBIS0.css +3 -0
  50. package/template/.build/_astro/{ec.8nqtp.css → ec.t9qpe.css} +1 -1
  51. package/template/.build/_astro/logo.BPu921Tp.svg +1 -0
  52. package/template/.build/_hgdc/corpus.json +1 -1
  53. package/template/.build/concepts/confidentialite/index.html +50 -0
  54. package/template/.build/concepts/confidentialite.md +38 -0
  55. package/template/.build/concepts/deploiements/index.html +106 -0
  56. package/template/.build/concepts/deploiements.md +70 -0
  57. package/template/.build/concepts/organisations-et-roles/index.html +83 -0
  58. package/template/.build/concepts/organisations-et-roles.md +39 -0
  59. package/template/.build/concepts/preversion/index.html +49 -0
  60. package/template/.build/concepts/preversion.md +52 -0
  61. package/template/.build/concepts/secrets-et-coffre/index.html +70 -0
  62. package/template/.build/concepts/secrets-et-coffre.md +54 -0
  63. package/template/.build/demarrer/depuis-github/index.html +34 -0
  64. package/template/.build/demarrer/depuis-github.md +68 -0
  65. package/template/.build/demarrer/premier-site/index.html +28 -0
  66. package/template/.build/demarrer/premier-site.md +94 -0
  67. package/template/.build/guides/brancher-un-domaine/index.html +91 -0
  68. package/template/.build/guides/brancher-un-domaine.md +81 -0
  69. package/template/.build/guides/cle-d-api/index.html +62 -0
  70. package/template/.build/guides/cle-d-api.md +78 -0
  71. package/template/.build/guides/depannage/index.html +64 -0
  72. package/template/.build/guides/depannage.md +69 -0
  73. package/template/.build/guides/deployer-depuis-github/index.html +45 -0
  74. package/template/.build/guides/deployer-depuis-github.md +70 -0
  75. package/template/.build/guides/deployer-un-framework/index.html +81 -0
  76. package/template/.build/guides/deployer-un-framework.md +74 -0
  77. package/template/.build/guides/github-actions-sans-application/index.html +53 -0
  78. package/template/.build/guides/github-actions-sans-application.md +95 -0
  79. package/template/.build/guides/inviter-une-personne/index.html +28 -0
  80. package/template/.build/guides/inviter-une-personne.md +38 -0
  81. package/template/.build/guides/lire-les-logs/index.html +37 -0
  82. package/template/.build/guides/lire-les-logs.md +48 -0
  83. package/template/.build/guides/migrer-depuis-vercel/index.html +25 -0
  84. package/template/.build/guides/migrer-depuis-vercel.md +51 -0
  85. package/template/.build/guides/monorepo/index.html +40 -0
  86. package/template/.build/guides/monorepo.md +42 -0
  87. package/template/.build/guides/revenir-en-arriere/index.html +39 -0
  88. package/template/.build/guides/revenir-en-arriere.md +50 -0
  89. package/template/.build/guides/site-statique/index.html +41 -0
  90. package/template/.build/guides/site-statique.md +59 -0
  91. package/template/.build/guides/synchroniser-doppler/index.html +46 -0
  92. package/template/.build/guides/synchroniser-doppler.md +63 -0
  93. package/template/.build/guides/variables-d-environnement/index.html +73 -0
  94. package/template/.build/guides/variables-d-environnement.md +92 -0
  95. package/template/.build/images/famille/account.svg +1 -0
  96. package/template/.build/images/famille/analytics.svg +1 -0
  97. package/template/.build/images/famille/docs.svg +1 -0
  98. package/template/.build/images/famille/host.svg +1 -0
  99. package/template/.build/images/famille/mail.svg +1 -0
  100. package/template/.build/images/famille/portal.svg +1 -0
  101. package/template/.build/images/famille/status.svg +1 -0
  102. package/template/.build/images/logo.svg +1 -0
  103. package/template/.build/index.html +30 -85
  104. package/template/.build/index.md +59 -21
  105. package/template/.build/llms-full.txt +2330 -514
  106. package/template/.build/llms.txt +51 -34
  107. package/template/.build/pagefind/fragment/fr-ch_16987e2.pf_fragment +0 -0
  108. package/template/.build/pagefind/fragment/fr-ch_2b4c97b.pf_fragment +0 -0
  109. package/template/.build/pagefind/fragment/fr-ch_3294a5c.pf_fragment +0 -0
  110. package/template/.build/pagefind/fragment/fr-ch_34858c9.pf_fragment +0 -0
  111. package/template/.build/pagefind/fragment/fr-ch_39ddba1.pf_fragment +0 -0
  112. package/template/.build/pagefind/fragment/fr-ch_4ab1899.pf_fragment +0 -0
  113. package/template/.build/pagefind/fragment/fr-ch_4d3a52a.pf_fragment +0 -0
  114. package/template/.build/pagefind/fragment/fr-ch_506c187.pf_fragment +0 -0
  115. package/template/.build/pagefind/fragment/fr-ch_5aa255a.pf_fragment +0 -0
  116. package/template/.build/pagefind/fragment/fr-ch_6841c7d.pf_fragment +0 -0
  117. package/template/.build/pagefind/fragment/fr-ch_6dc7a2d.pf_fragment +0 -0
  118. package/template/.build/pagefind/fragment/fr-ch_847edff.pf_fragment +0 -0
  119. package/template/.build/pagefind/fragment/fr-ch_8745af7.pf_fragment +0 -0
  120. package/template/.build/pagefind/fragment/fr-ch_8aac5e6.pf_fragment +0 -0
  121. package/template/.build/pagefind/fragment/fr-ch_916b233.pf_fragment +0 -0
  122. package/template/.build/pagefind/fragment/fr-ch_9fd014a.pf_fragment +0 -0
  123. package/template/.build/pagefind/fragment/fr-ch_a0808f8.pf_fragment +0 -0
  124. package/template/.build/pagefind/fragment/fr-ch_a4e1f69.pf_fragment +0 -0
  125. package/template/.build/pagefind/fragment/fr-ch_a80a53d.pf_fragment +0 -0
  126. package/template/.build/pagefind/fragment/fr-ch_a9e725b.pf_fragment +0 -0
  127. package/template/.build/pagefind/fragment/fr-ch_ac3f64c.pf_fragment +0 -0
  128. package/template/.build/pagefind/fragment/fr-ch_af292f1.pf_fragment +0 -0
  129. package/template/.build/pagefind/fragment/fr-ch_af3e716.pf_fragment +0 -0
  130. package/template/.build/pagefind/fragment/fr-ch_b0689a4.pf_fragment +0 -0
  131. package/template/.build/pagefind/fragment/fr-ch_baed996.pf_fragment +0 -0
  132. package/template/.build/pagefind/fragment/fr-ch_c89e27a.pf_fragment +0 -0
  133. package/template/.build/pagefind/fragment/fr-ch_cd6ca13.pf_fragment +0 -0
  134. package/template/.build/pagefind/fragment/fr-ch_d09af09.pf_fragment +0 -0
  135. package/template/.build/pagefind/fragment/fr-ch_d4bcea8.pf_fragment +0 -0
  136. package/template/.build/pagefind/fragment/fr-ch_dc2a134.pf_fragment +0 -0
  137. package/template/.build/pagefind/fragment/fr-ch_ded7ddc.pf_fragment +0 -0
  138. package/template/.build/pagefind/fragment/fr-ch_e2528cb.pf_fragment +0 -0
  139. package/template/.build/pagefind/fragment/fr-ch_e3cbb4e.pf_fragment +0 -0
  140. package/template/.build/pagefind/fragment/fr-ch_e7902d9.pf_fragment +0 -0
  141. package/template/.build/pagefind/fragment/fr-ch_f48ca47.pf_fragment +0 -0
  142. package/template/.build/pagefind/index/fr-ch_8a5f905.pf_index +0 -0
  143. package/template/.build/pagefind/index/fr-ch_fbd9c96.pf_index +0 -0
  144. package/template/.build/pagefind/pagefind-entry.json +1 -1
  145. package/template/.build/pagefind/pagefind.fr-ch_211aacbfa7f0e.pf_meta +0 -0
  146. package/template/.build/reference/api/deploiements/index.html +326 -0
  147. package/template/.build/reference/api/deploiements.md +170 -0
  148. package/template/.build/reference/api/erreurs/index.html +102 -0
  149. package/template/.build/reference/api/erreurs.md +50 -0
  150. package/template/.build/reference/api/fichiers/index.html +82 -0
  151. package/template/.build/reference/api/fichiers.md +62 -0
  152. package/template/.build/reference/api/introduction/index.html +126 -0
  153. package/template/.build/reference/api/introduction.md +84 -0
  154. package/template/.build/reference/api/projets/index.html +184 -0
  155. package/template/.build/reference/api/projets.md +102 -0
  156. package/template/.build/reference/api/utilisateur/index.html +96 -0
  157. package/template/.build/reference/api/utilisateur.md +89 -0
  158. package/template/.build/reference/api/variables/index.html +75 -0
  159. package/template/.build/reference/api/variables.md +58 -0
  160. package/template/.build/reference/cli/index.html +165 -82
  161. package/template/.build/reference/cli.md +159 -23
  162. package/template/.build/reference/compatibilite/index.html +196 -0
  163. package/template/.build/reference/compatibilite.md +64 -0
  164. package/template/.build/reference/domaines/index.html +171 -0
  165. package/template/.build/reference/domaines.md +76 -0
  166. package/template/.build/reference/limites/index.html +159 -0
  167. package/template/.build/reference/limites.md +56 -0
  168. package/template/.build/reference/variables/index.html +164 -0
  169. package/template/.build/reference/variables.md +63 -0
  170. package/template/.build/reference/vercel-json/index.html +65 -0
  171. package/template/.build/reference/vercel-json.md +51 -0
  172. package/template/node_modules/.vite/deps/_metadata.json +8 -8
  173. package/template/src/content.config.ts +8 -2
  174. package/src/overrides/SocialIcons.astro +0 -59
  175. package/template/.build/_astro/Assistant.astro_astro_type_script_index_0_lang.DWgmlr85.js +0 -4
  176. package/template/.build/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.C3fM4Kra.js +0 -1
  177. package/template/.build/_astro/Search.astro_astro_type_script_index_0_lang.g9hoxVJg.js +0 -1
  178. package/template/.build/_astro/TableOfContents.astro_astro_type_script_index_0_lang.BpJaGz7G.js +0 -1
  179. package/template/.build/_astro/common.CQYUsl_5.css +0 -3
  180. package/template/.build/_astro/logo-clair.BqNh6JNi.svg +0 -1
  181. package/template/.build/_astro/logo-sombre.BkgsFXxh.svg +0 -1
  182. package/template/.build/_astro/starlight-toc.D4UDIxQL.js +0 -1
  183. package/template/.build/_astro/ui-core.Clh5jUUO.js +0 -2
  184. package/template/.build/demarrer/premiere-doc/index.html +0 -84
  185. package/template/.build/demarrer/premiere-doc.md +0 -65
  186. package/template/.build/explications/donnees/index.html +0 -114
  187. package/template/.build/explications/donnees.md +0 -28
  188. package/template/.build/explications/fonctionnement/index.html +0 -92
  189. package/template/.build/explications/fonctionnement.md +0 -32
  190. package/template/.build/guides/agents/index.html +0 -118
  191. package/template/.build/guides/agents.md +0 -54
  192. package/template/.build/guides/assistant/index.html +0 -119
  193. package/template/.build/guides/assistant.md +0 -46
  194. package/template/.build/guides/composants/index.html +0 -97
  195. package/template/.build/guides/composants.md +0 -103
  196. package/template/.build/guides/ecrire/index.html +0 -115
  197. package/template/.build/guides/ecrire.md +0 -63
  198. package/template/.build/guides/elements/index.html +0 -1
  199. package/template/.build/guides/navigation/index.html +0 -89
  200. package/template/.build/guides/navigation.md +0 -63
  201. package/template/.build/guides/publier/index.html +0 -86
  202. package/template/.build/guides/publier.md +0 -65
  203. package/template/.build/guides/theme/index.html +0 -86
  204. package/template/.build/guides/theme.md +0 -33
  205. package/template/.build/images/favicon.svg +0 -1
  206. package/template/.build/images/logo-clair.svg +0 -1
  207. package/template/.build/images/logo-sombre.svg +0 -1
  208. package/template/.build/pagefind/fragment/fr-ch_148313b.pf_fragment +0 -0
  209. package/template/.build/pagefind/fragment/fr-ch_2a431a9.pf_fragment +0 -0
  210. package/template/.build/pagefind/fragment/fr-ch_35f556a.pf_fragment +0 -0
  211. package/template/.build/pagefind/fragment/fr-ch_456586a.pf_fragment +0 -0
  212. package/template/.build/pagefind/fragment/fr-ch_48ca71e.pf_fragment +0 -0
  213. package/template/.build/pagefind/fragment/fr-ch_4f8575c.pf_fragment +0 -0
  214. package/template/.build/pagefind/fragment/fr-ch_72b91f4.pf_fragment +0 -0
  215. package/template/.build/pagefind/fragment/fr-ch_8f256dd.pf_fragment +0 -0
  216. package/template/.build/pagefind/fragment/fr-ch_95a15cc.pf_fragment +0 -0
  217. package/template/.build/pagefind/fragment/fr-ch_aa80c55.pf_fragment +0 -0
  218. package/template/.build/pagefind/fragment/fr-ch_ab79738.pf_fragment +0 -0
  219. package/template/.build/pagefind/fragment/fr-ch_c589c2a.pf_fragment +0 -0
  220. package/template/.build/pagefind/fragment/fr-ch_dab8f5e.pf_fragment +0 -0
  221. package/template/.build/pagefind/fragment/fr-ch_de60b43.pf_fragment +0 -0
  222. package/template/.build/pagefind/fragment/fr-ch_e2c46e3.pf_fragment +0 -0
  223. package/template/.build/pagefind/index/fr-ch_c5ced52.pf_index +0 -0
  224. package/template/.build/pagefind/pagefind.fr-ch_8a246aa922758.pf_meta +0 -0
  225. package/template/.build/reference/api-assistant/index.html +0 -161
  226. package/template/.build/reference/api-assistant.md +0 -60
  227. package/template/.build/reference/docs-json/index.html +0 -216
  228. package/template/.build/reference/docs-json.md +0 -47
  229. package/template/.build/reference/mcp/index.html +0 -151
  230. package/template/.build/reference/mcp.md +0 -49
package/template/.build/guides/composants/index.html DELETED
@@ -1,97 +0,0 @@
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>Composants | 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="Composants"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Encadrés, étapes, cartes, onglets et accordéons, disponibles dans chaque page sans import."/><meta property="og:site_name" content="Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Encadrés, étapes, cartes, onglets et accordéons, disponibles dans chaque page sans import."/><link rel="alternate" type="text/markdown" href="/guides/composants.md"><link rel="describedby" type="text/markdown" href="/llms.txt"><script>
2
- window.StarlightThemeProvider = (() => {
3
- const storedTheme =
4
- typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
5
- const theme =
6
- storedTheme ||
7
- (window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
8
- document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
9
- return {
10
- updatePickers(theme = storedTheme || 'auto') {
11
- document.querySelectorAll('starlight-theme-select').forEach((picker) => {
12
- const select = picker.querySelector('select');
13
- if (select) select.value = theme;
14
- /** @type {HTMLTemplateElement | null} */
15
- const tmpl = document.querySelector(`#theme-icons`);
16
- const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
17
- if (newIcon) {
18
- const oldIcon = picker.querySelector('svg.label-icon');
19
- if (oldIcon) {
20
- oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
21
- }
22
- }
23
- });
24
- },
25
- };
26
- })();
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="{&quot;placeholder&quot;:&quot;Rechercher&quot;}"><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
- (() => {
31
- const openBtn = document.querySelector('button[data-open-modal]');
32
- const shortcut = openBtn?.querySelector('kbd');
33
- if (!openBtn || !(shortcut instanceof HTMLElement)) return;
34
- const platformKey = shortcut.querySelector('kbd');
35
- if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
36
- platformKey.textContent = '⌘';
37
- openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
38
- }
39
- shortcut.style.display = '';
40
- })();
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
- 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-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
- (() => {
45
- try {
46
- if (!matchMedia('(min-width: 50em)').matches) return;
47
- /** @type {HTMLElement | null} */
48
- const target = document.querySelector('sl-sidebar-state-persist');
49
- const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
50
- if (!target || !state || target.dataset.hash !== state.hash) return;
51
- window._starlightScrollRestore = state.scroll;
52
- customElements.define(
53
- 'sl-sidebar-restore',
54
- class SidebarRestore extends HTMLElement {
55
- connectedCallback() {
56
- try {
57
- const idx = parseInt(this.dataset.index || '');
58
- const details = this.closest('details');
59
- if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
60
- } catch {}
61
- }
62
- }
63
- );
64
- } catch {}
65
- })();
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="/" 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/" aria-current="page" 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
- (() => {
68
- const scroller = document.getElementById('starlight__sidebar');
69
- if (!window._starlightScrollRestore || !scroller) return;
70
- scroller.scrollTop = window._starlightScrollRestore;
71
- delete window._starlightScrollRestore;
72
- })();
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
- StarlightThemeProvider.updatePickers();
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="#encadrés" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Encadrés</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#étapes" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Étapes</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#cartes" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Cartes</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#onglets" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Onglets</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#accordéons" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Accordéons</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#dans-le-markdown-publié" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Dans le Markdown publié</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="#encadrés" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Encadrés</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#étapes" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Étapes</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#cartes" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Cartes</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#onglets" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Onglets</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#accordéons" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Accordéons</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#dans-le-markdown-publié" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Dans le Markdown publié</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">Composants</h1><div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore><button type="button" class="hgdc-action" data-hgdc-copy="/guides/composants.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="/guides/composants.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>Ces composants s’utilisent directement dans une page <code>.mdx</code>, sans <code>import</code>. Ils portent les mêmes noms que chez Mintlify.</p>
76
- <h2 id="encadrés">Encadrés</h2>
77
- <aside aria-label="Note" class="starlight-aside starlight-aside--note"><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 d="M12 11a1 1 0 0 0-1 1v4a1 1 0 0 0 2 0v-4a1 1 0 0 0-1-1Zm.38-3.92a1 1 0 0 0-.76 0 1 1 0 0 0-.33.21 1.15 1.15 0 0 0-.21.33 1 1 0 0 0 .21 1.09c.097.088.209.16.33.21A1 1 0 0 0 13 8a1.05 1.05 0 0 0-.29-.71 1 1 0 0 0-.33-.21ZM12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm0 18a8 8 0 1 1 0-16.001A8 8 0 0 1 12 20Z"/></svg>Note</p><div class="starlight-aside__content">Une information utile à côté du texte.</div></aside>
78
- <aside aria-label="Astuce" 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>Astuce</p><div class="starlight-aside__content">Un conseil qui fait gagner du temps.</div></aside>
79
- <aside aria-label="Attention" class="starlight-aside starlight-aside--caution"><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 d="M12 16a1 1 0 1 0 0 2 1 1 0 0 0 0-2Zm10.67 1.47-8.05-14a3 3 0 0 0-5.24 0l-8 14A3 3 0 0 0 3.94 22h16.12a3 3 0 0 0 2.61-4.53Zm-1.73 2a1 1 0 0 1-.88.51H3.94a1 1 0 0 1-.88-.51 1 1 0 0 1 0-1l8-14a1 1 0 0 1 1.78 0l8.05 14a1 1 0 0 1 .05 1.02v-.02ZM12 8a1 1 0 0 0-1 1v4a1 1 0 0 0 2 0V9a1 1 0 0 0-1-1Z"/></svg>Attention</p><div class="starlight-aside__content">Un piège à éviter.</div></aside>
80
- <aside aria-label="Danger" class="starlight-aside starlight-aside--danger"><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 d="M12 7a1 1 0 0 0-1 1v4a1 1 0 0 0 2 0V8a1 1 0 0 0-1-1Zm0 8a1 1 0 1 0 0 2 1 1 0 0 0 0-2Zm9.71-7.44-5.27-5.27a1.05 1.05 0 0 0-.71-.29H8.27a1.05 1.05 0 0 0-.71.29L2.29 7.56a1.05 1.05 0 0 0-.29.71v7.46c.004.265.107.518.29.71l5.27 5.27c.192.183.445.286.71.29h7.46a1.05 1.05 0 0 0 .71-.29l5.27-5.27a1.05 1.05 0 0 0 .29-.71V8.27a1.05 1.05 0 0 0-.29-.71ZM20 15.31 15.31 20H8.69L4 15.31V8.69L8.69 4h6.62L20 8.69v6.62Z"/></svg>Danger</p><div class="starlight-aside__content">Une action qui détruit des données.</div></aside>
81
- <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="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Note</span><span style="--0:#E6EDF3;--1:#1F2328">>Une information utile à côté du texte.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Note</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Tip</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Astuce"</span><span style="--0:#E6EDF3;--1:#1F2328">>Un conseil qui fait gagner du temps.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Tip</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Warning</span><span style="--0:#E6EDF3;--1:#1F2328">>Un piège à éviter.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Warning</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Danger</span><span style="--0:#E6EDF3;--1:#1F2328">>Une action qui détruit des données.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Danger</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<Note>Une information utile à côté du texte.</Note><Tip title=&#x22;Astuce&#x22;>Un conseil qui fait gagner du temps.</Tip><Warning>Un piège à éviter.</Warning><Danger>Une action qui détruit des données.</Danger>"><div></div></button></div></figure></div>
82
- <p><code>&#x3C;Info></code> et <code>&#x3C;Check></code> existent aussi. Chacun accepte un <code>title</code>.</p>
83
- <h2 id="étapes">Étapes</h2>
84
- <ol class="hgdc-steps"><li class="hgdc-step"><p class="hgdc-step__title">Installer</p><div class="hgdc-step__body">Ajoute le paquet.</div></li><li class="hgdc-step"><p class="hgdc-step__title">Configurer</p><div class="hgdc-step__body">Écris <code>docs.json</code>.</div></li></ol>
85
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Steps</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Step</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Installer"</span><span style="--0:#E6EDF3;--1:#1F2328">>Ajoute le paquet.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Step</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Step</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Configurer"</span><span style="--0:#E6EDF3;--1:#1F2328">>Écris </span><span style="--0:#A5D6FF;--1:#0A3069">`</span><span style="--0:#79C0FF;--1:#0550AE">docs.json</span><span style="--0:#A5D6FF;--1:#0A3069">`</span><span style="--0:#E6EDF3;--1:#1F2328">.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Step</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Steps</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<Steps> <Step title=&#x22;Installer&#x22;>Ajoute le paquet.</Step> <Step title=&#x22;Configurer&#x22;>Écris &#x60;docs.json&#x60;.</Step></Steps>"><div></div></button></div></figure></div>
86
- <h2 id="cartes">Cartes</h2>
87
- <div class="hgdc-card-group not-content" style="--hgdc-cols:2"><a href="/guides/publier/" class="hgdc-card hgdc-card--link"><span class="hgdc-card__title">Avec un lien</span><div class="hgdc-card__body">Toute la carte est cliquable.</div></a><div class="hgdc-card"><span class="hgdc-card__title">Sans lien</span><div class="hgdc-card__body">Pour présenter une idée.</div></div></div>
88
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">CardGroup</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">cols</span><span style="--0:#FF7B72;--1:#CA212D">={</span><span style="--0:#79C0FF;--1:#0550AE">2</span><span style="--0:#FF7B72;--1:#CA212D">}</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Card</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Avec un lien"</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">href</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"/guides/publier/"</span><span style="--0:#E6EDF3;--1:#1F2328">>Toute la carte est cliquable.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Card</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Card</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Sans lien"</span><span style="--0:#E6EDF3;--1:#1F2328">>Pour présenter une idée.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Card</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;/</span><span style="--0:#7EE787;--1:#116329">CardGroup</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<CardGroup cols={2}> <Card title=&#x22;Avec un lien&#x22; href=&#x22;/guides/publier/&#x22;>Toute la carte est cliquable.</Card> <Card title=&#x22;Sans lien&#x22;>Pour présenter une idée.</Card></CardGroup>"><div></div></button></div></figure></div>
89
- <p><code>cols</code> va de 1 à 4. Sur téléphone, les cartes passent l’une sous l’autre.</p>
90
- <h2 id="onglets">Onglets</h2>
91
- <starlight-tabs class="astro-ygjryhu4"><div class="tablist-wrapper not-content astro-ygjryhu4"><ul role="tablist" class="astro-ygjryhu4"><li role="presentation" class="tab astro-ygjryhu4"><a role="tab" href="#tab-panel-0-0" id="tab-0-0" aria-selected="true" tabindex="0" class="astro-ygjryhu4">npm</a></li><li role="presentation" class="tab astro-ygjryhu4"><a role="tab" href="#tab-panel-0-1" id="tab-0-1" aria-selected="false" tabindex="-1" class="astro-ygjryhu4">Bun</a></li></ul></div><div id="tab-panel-0-0" aria-labelledby="tab-0-0" role="tabpanel"><div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Fenêtre de terminal</span></figcaption><pre data-language="bash"><code><div class="ec-line"><div class="code"><span style="--0:#FFA657;--1:#953800">npm</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">install</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">--save-dev</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">@hgdc/docs</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="npm install --save-dev @hgdc/docs"><div></div></button></div></figure></div></div><div id="tab-panel-0-1" aria-labelledby="tab-0-1" role="tabpanel" hidden><div class="expressive-code"><figure class="frame is-terminal not-content"><figcaption class="header"><span class="title"></span><span class="sr-only">Fenêtre de terminal</span></figcaption><pre data-language="bash"><code><div class="ec-line"><div class="code"><span style="--0:#FFA657;--1:#953800">bun</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">add</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">--dev</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">@hgdc/docs</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="bun add --dev @hgdc/docs"><div></div></button></div></figure></div></div></starlight-tabs><script type="module">var e=class e extends HTMLElement{static#e=new Map;tabs;panels;#t;#n=`starlight-synced-tabs__`;constructor(){super();let t=this.querySelector(`[role="tablist"]`);if(this.tabs=[...t.querySelectorAll(`[role="tab"]`)],this.panels=[...this.querySelectorAll(`:scope > [role="tabpanel"]`)],this.#t=this.dataset.syncKey,this.#t){let t=e.#e.get(this.#t)??[];t.push(this),e.#e.set(this.#t,t)}this.tabs.forEach((e,n)=>{e.addEventListener(`click`,e=>{e.preventDefault();let r=t.querySelector(`[aria-selected="true"]`);e.currentTarget!==r&&this.switchTab(e.currentTarget,n)}),e.addEventListener(`keydown`,e=>{let t=this.tabs.indexOf(e.currentTarget),n=e.key===`ArrowLeft`?t-1:e.key===`ArrowRight`?t+1:e.key===`Home`?0:e.key===`End`?this.tabs.length-1:null;n!==null&&this.tabs[n]&&(e.preventDefault(),this.switchTab(this.tabs[n],n))})})}switchTab(t,n,r=!0){if(!t)return;let i=r?this.getBoundingClientRect().top:0;this.tabs.forEach(e=>{e.setAttribute(`aria-selected`,`false`),e.setAttribute(`tabindex`,`-1`)}),this.panels.forEach(e=>{e.hidden=!0});let a=this.panels[n];a&&(a.hidden=!1),t.removeAttribute(`tabindex`),t.setAttribute(`aria-selected`,`true`),r&&(t.focus(),e.#i(this,t),window.scrollTo({top:window.scrollY+(this.getBoundingClientRect().top-i),behavior:`instant`}))}#r(e){this.#t&&typeof localStorage<`u`&&localStorage.setItem(this.#n+this.#t,e)}static#i(t,n){let r=t.#t,i=e.#a(n);if(!r||!i)return;let a=e.#e.get(r);if(a){for(let n of a){if(n===t)continue;let r=n.tabs.findIndex(t=>e.#a(t)===i);r!==-1&&n.switchTab(n.tabs[r],r,!1)}t.#r(i)}}static#a(e){return e.textContent?.trim()}};customElements.define(`starlight-tabs`,e);</script>
92
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Tabs</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Tab</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"npm"</span><span style="--0:#E6EDF3;--1:#1F2328">>…&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Tab</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Tab</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Bun"</span><span style="--0:#E6EDF3;--1:#1F2328">>…&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Tab</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Tabs</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<Tabs> <Tab title=&#x22;npm&#x22;>…</Tab> <Tab title=&#x22;Bun&#x22;>…</Tab></Tabs>"><div></div></button></div></figure></div>
93
- <h2 id="accordéons">Accordéons</h2>
94
- <div class="hgdc-accordion-group"><details class="hgdc-accordion"><summary>Faut-il un compte HGDC pour écrire ?</summary><div class="hgdc-accordion__body"><p>Non. Le site se construit sans compte. Le compte sert à la console : publication suivie et assistant.</p></div></details><details class="hgdc-accordion"><summary>Puis-je garder mes composants Mintlify ?</summary><div class="hgdc-accordion__body"><p>Ceux de cette page, oui. Les autres s’affichent comme du texte : remplace-les ou écris-nous.</p></div></details></div>
95
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">AccordionGroup</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"><span style="--0:#E6EDF3;--1:#1F2328"> </span></span><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Accordion</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">title</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Question"</span><span style="--0:#E6EDF3;--1:#1F2328">>Réponse.&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Accordion</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;/</span><span style="--0:#7EE787;--1:#116329">AccordionGroup</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<AccordionGroup> <Accordion title=&#x22;Question&#x22;>Réponse.</Accordion></AccordionGroup>"><div></div></button></div></figure></div>
96
- <h2 id="dans-le-markdown-publié">Dans le Markdown publié</h2>
97
- <p>Chaque composant a une forme Markdown : un encadré devient une citation qui commence par son titre en gras, une étape devient un élément de liste numérotée. C’est cette forme que lisent l’assistant, <code>llms.txt</code> et les outils d’IA.</p></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="/guides/ecrire/" rel="prev" 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 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-ofihuwrj">Précédent<br class="astro-ofihuwrj"><span class="link-title astro-ofihuwrj">Écrire en MDX</span></span></a><a href="/guides/navigation/" 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">Navigation</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/guides/composants.md DELETED
@@ -1,103 +0,0 @@
1
- # Composants
2
-
3
- Ces composants s’utilisent directement dans une page `.mdx`, sans `import`. Ils portent les mêmes noms que chez Mintlify.
4
-
5
- ## Encadrés
6
-
7
- > **Note**
8
- >
9
- > Une information utile à côté du texte.
10
-
11
- > **Astuce**
12
- >
13
- > Un conseil qui fait gagner du temps.
14
-
15
- > **Attention**
16
- >
17
- > Un piège à éviter.
18
-
19
- > **Danger**
20
- >
21
- > Une action qui détruit des données.
22
-
23
- ```mdx
24
- <Note>Une information utile à côté du texte.</Note>
25
- <Tip title="Astuce">Un conseil qui fait gagner du temps.</Tip>
26
- <Warning>Un piège à éviter.</Warning>
27
- <Danger>Une action qui détruit des données.</Danger>
28
- ```
29
-
30
- `<Info>` et `<Check>` existent aussi. Chacun accepte un `title`.
31
-
32
- ## Étapes
33
-
34
- 1. **Installer**
35
-
36
- Ajoute le paquet.
37
-
38
- 2. **Configurer**
39
-
40
- Écris `docs.json`.
41
-
42
- ```mdx
43
- <Steps>
44
- <Step title="Installer">Ajoute le paquet.</Step>
45
- <Step title="Configurer">Écris `docs.json`.</Step>
46
- </Steps>
47
- ```
48
-
49
- ## Cartes
50
-
51
- [Avec un lien](/guides/publier/)
52
-
53
- [Toute la carte est cliquable.](/guides/publier/)
54
-
55
- Sans lien
56
-
57
- Pour présenter une idée.
58
-
59
- ```mdx
60
- <CardGroup cols={2}>
61
- <Card title="Avec un lien" href="/guides/publier/">Toute la carte est cliquable.</Card>
62
- <Card title="Sans lien">Pour présenter une idée.</Card>
63
- </CardGroup>
64
- ```
65
-
66
- `cols` va de 1 à 4. Sur téléphone, les cartes passent l’une sous l’autre.
67
-
68
- ## Onglets
69
-
70
- ```bash
71
- npm install --save-dev @hgdc/docs
72
- ```
73
-
74
- ```bash
75
- bun add --dev @hgdc/docs
76
- ```
77
-
78
- ```mdx
79
- <Tabs>
80
- <Tab title="npm">…</Tab>
81
- <Tab title="Bun">…</Tab>
82
- </Tabs>
83
- ```
84
-
85
- ## Accordéons
86
-
87
- Faut-il un compte HGDC pour écrire ?
88
-
89
- Non. Le site se construit sans compte. Le compte sert à la console : publication suivie et assistant.
90
-
91
- Puis-je garder mes composants Mintlify ?
92
-
93
- Ceux de cette page, oui. Les autres s’affichent comme du texte : remplace-les ou écris-nous.
94
-
95
- ```mdx
96
- <AccordionGroup>
97
- <Accordion title="Question">Réponse.</Accordion>
98
- </AccordionGroup>
99
- ```
100
-
101
- ## Dans le Markdown publié
102
-
103
- Chaque composant a une forme Markdown : un encadré devient une citation qui commence par son titre en gras, une étape devient un élément de liste numérotée. C’est cette forme que lisent l’assistant, `llms.txt` et les outils d’IA.
package/template/.build/guides/ecrire/index.html DELETED
@@ -1,115 +0,0 @@
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>Écrire en MDX | 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="Écrire en MDX"/><meta property="og:type" content="article"/><meta property="og:locale" content="fr-CH"/><meta property="og:description" content="Titres, liens, images, code et métadonnées d'une page."/><meta property="og:site_name" content="Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="description" content="Titres, liens, images, code et métadonnées d'une page."/><link rel="alternate" type="text/markdown" href="/guides/ecrire.md"><link rel="describedby" type="text/markdown" href="/llms.txt"><script>
2
- window.StarlightThemeProvider = (() => {
3
- const storedTheme =
4
- typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
5
- const theme =
6
- storedTheme ||
7
- (window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
8
- document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
9
- return {
10
- updatePickers(theme = storedTheme || 'auto') {
11
- document.querySelectorAll('starlight-theme-select').forEach((picker) => {
12
- const select = picker.querySelector('select');
13
- if (select) select.value = theme;
14
- /** @type {HTMLTemplateElement | null} */
15
- const tmpl = document.querySelector(`#theme-icons`);
16
- const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
17
- if (newIcon) {
18
- const oldIcon = picker.querySelector('svg.label-icon');
19
- if (oldIcon) {
20
- oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
21
- }
22
- }
23
- });
24
- },
25
- };
26
- })();
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="{&quot;placeholder&quot;:&quot;Rechercher&quot;}"><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
- (() => {
31
- const openBtn = document.querySelector('button[data-open-modal]');
32
- const shortcut = openBtn?.querySelector('kbd');
33
- if (!openBtn || !(shortcut instanceof HTMLElement)) return;
34
- const platformKey = shortcut.querySelector('kbd');
35
- if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
36
- platformKey.textContent = '⌘';
37
- openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
38
- }
39
- shortcut.style.display = '';
40
- })();
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
- 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-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
- (() => {
45
- try {
46
- if (!matchMedia('(min-width: 50em)').matches) return;
47
- /** @type {HTMLElement | null} */
48
- const target = document.querySelector('sl-sidebar-state-persist');
49
- const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
50
- if (!target || !state || target.dataset.hash !== state.hash) return;
51
- window._starlightScrollRestore = state.scroll;
52
- customElements.define(
53
- 'sl-sidebar-restore',
54
- class SidebarRestore extends HTMLElement {
55
- connectedCallback() {
56
- try {
57
- const idx = parseInt(this.dataset.index || '');
58
- const details = this.closest('details');
59
- if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
60
- } catch {}
61
- }
62
- }
63
- );
64
- } catch {}
65
- })();
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="/" 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/" aria-current="page" 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
- (() => {
68
- const scroller = document.getElementById('starlight__sidebar');
69
- if (!window._starlightScrollRestore || !scroller) return;
70
- scroller.scrollTop = window._starlightScrollRestore;
71
- delete window._starlightScrollRestore;
72
- })();
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
- StarlightThemeProvider.updatePickers();
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="#métadonnées" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Métadonnées</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#titres-et-sections" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Titres et sections</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#liens" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Liens</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#images" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Images</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#code" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Code</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#ce-qui-nest-pas-publié" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Ce qui n’est pas publié</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="#métadonnées" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Métadonnées</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#titres-et-sections" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Titres et sections</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#liens" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Liens</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#images" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Images</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#code" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Code</span></a></li><li style="--depth: 0;" class="astro-vrgp5ku5"><a href="#ce-qui-nest-pas-publié" style="--depth: 0;" class="astro-vrgp5ku5"><span style="--depth: 0;" class="astro-vrgp5ku5">Ce qui n’est pas publié</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">Écrire en MDX</h1><div class="hgdc-page-actions not-content" data-hgdc-skip data-pagefind-ignore><button type="button" class="hgdc-action" data-hgdc-copy="/guides/ecrire.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="/guides/ecrire.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>Chaque page est un fichier <code>.mdx</code> (ou <code>.md</code>) : du Markdown, plus des composants. Le chemin du fichier donne l’adresse de la page : <code>guides/publier.mdx</code> devient <code>/guides/publier/</code>.</p>
76
- <h2 id="métadonnées">Métadonnées</h2>
77
- <p>Le haut de la page, entre deux lignes <code>---</code>, décrit la page.</p>
78
- <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="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#A5D6FF;--1:#0A3069">---</span></div></div><div class="ec-line"><div class="code"><span style="--0:#7EE787;--1:#116329">title</span><span style="--0:#E6EDF3;--1:#1F2328">: </span><span style="--0:#A5D6FF;--1:#0A3069">Publier avec Host</span></div></div><div class="ec-line"><div class="code"><span style="--0:#7EE787;--1:#116329">sidebarTitle</span><span style="--0:#E6EDF3;--1:#1F2328">: </span><span style="--0:#A5D6FF;--1:#0A3069">Publier</span></div></div><div class="ec-line"><div class="code"><span style="--0:#7EE787;--1:#116329">description</span><span style="--0:#E6EDF3;--1:#1F2328">: </span><span style="--0:#A5D6FF;--1:#0A3069">Mettre la doc en ligne et brancher l'assistant.</span></div></div><div class="ec-line"><div class="code"><span style="--0:#A5D6FF;--1:#0A3069">---</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="---title: Publier avec HostsidebarTitle: Publierdescription: Mettre la doc en ligne et brancher l&#x27;assistant.---"><div></div></button></div></figure></div>
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
- <table><thead><tr><th>Champ</th><th>Rôle</th></tr></thead><tbody><tr><td><code>title</code></td><td>Titre de la page, obligatoire. Aussi le titre de l’onglet du navigateur.</td></tr><tr><td><code>sidebarTitle</code></td><td>Libellé plus court dans la barre latérale.</td></tr><tr><td><code>description</code></td><td>Une phrase. Reprise par les moteurs de recherche, <code>llms.txt</code> et l’assistant.</td></tr></tbody></table>
101
- <h2 id="titres-et-sections">Titres et sections</h2>
102
- <p>Commence les sections à <code>##</code>. Chaque titre reçoit une ancre (<code>#publier-avec-host</code>) : c’est elle que l’assistant cite dans ses sources. Un titre clair donne donc une source claire.</p>
103
- <aside aria-label="Astuce" 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>Astuce</p><div class="starlight-aside__content"><p>Une section par question qu’on te pose. L’assistant découpe la doc par titre : une section courte et nommée simplement est retrouvée plus souvent.</p></div></aside>
104
- <h2 id="liens">Liens</h2>
105
- <p>Les liens internes s’écrivent avec le chemin de la page : <code>[Publier](/guides/publier/)</code>. Pour une section : <code>[le domaine](/guides/publier/#ton-domaine)</code>.</p>
106
- <h2 id="images">Images</h2>
107
- <p>Range les images dans <code>images/</code>, <code>img/</code>, <code>logo/</code>, <code>assets/</code> ou <code>static/</code>, et cite-les avec un chemin qui commence par <code>/</code>. Seuls les médias de ces dossiers, le logo et le favicon de <code>docs.json</code>, et tout le dossier <code>public/</code> (servi à la racine) sont publiés : un fichier oublié ailleurs dans le dépôt ne part jamais en ligne.</p>
108
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#A5D6FF;--1:#0A3069">![</span><span style="--0:#E6EDF3;--1:#1F2328">Le tableau de bord</span><span style="--0:#A5D6FF;--1:#0A3069">](/images/tableau-de-bord.png)</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="![Le tableau de bord](/images/tableau-de-bord.png)"><div></div></button></div></figure></div>
109
- <p>Pour une légende, entoure l’image d’un cadre :</p>
110
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;</span><span style="--0:#7EE787;--1:#116329">Frame</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#79C0FF;--1:#0550AE">caption</span><span style="--0:#FF7B72;--1:#CA212D">=</span><span style="--0:#A5D6FF;--1:#0A3069">"Le tableau de bord après la première publication"</span><span style="--0:#E6EDF3;--1:#1F2328">></span></div></div><div class="ec-line"><div class="code"><span class="indent"> </span><span style="--0:#A5D6FF;--1:#0A3069">![</span><span style="--0:#E6EDF3;--1:#1F2328">Le tableau de bord</span><span style="--0:#A5D6FF;--1:#0A3069">](/images/tableau-de-bord.png)</span></div></div><div class="ec-line"><div class="code"><span style="--0:#E6EDF3;--1:#1F2328">&#x3C;/</span><span style="--0:#7EE787;--1:#116329">Frame</span><span style="--0:#E6EDF3;--1:#1F2328">></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="<Frame caption=&#x22;Le tableau de bord après la première publication&#x22;> ![Le tableau de bord](/images/tableau-de-bord.png)</Frame>"><div></div></button></div></figure></div>
111
- <h2 id="code">Code</h2>
112
- <p>Les blocs de code sont colorés et ont un bouton Copier. Indique le langage après les trois accents graves :</p>
113
- <div class="expressive-code"><figure class="frame not-content"><figcaption class="header"></figcaption><pre data-language="mdx"><code><div class="ec-line"><div class="code"><span style="--0:#A5D6FF;--1:#0A3069">```</span><span style="--0:#D2A8FF;--1:#7A4BD1">bash</span></div></div><div class="ec-line"><div class="code"><span style="--0:#FFA657;--1:#953800">npm</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">run</span><span style="--0:#E6EDF3;--1:#1F2328"> </span><span style="--0:#A5D6FF;--1:#0A3069">build</span></div></div><div class="ec-line"><div class="code"><span style="--0:#A5D6FF;--1:#0A3069">```</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="&#x60;&#x60;&#x60;bashnpm run build&#x60;&#x60;&#x60;"><div></div></button></div></figure></div>
114
- <h2 id="ce-qui-nest-pas-publié">Ce qui n’est pas publié</h2>
115
- <p>Les fichiers qui commencent par <code>_</code> (comme <code>_brouillon.mdx</code>), <code>README.md</code>, <code>CHANGELOG.md</code> et les dossiers <code>node_modules</code>, <code>dist</code> ou cachés ne deviennent pas des pages.</p></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="/guides/publier/" rel="prev" 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 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-ofihuwrj">Précédent<br class="astro-ofihuwrj"><span class="link-title astro-ofihuwrj">Publier</span></span></a><a href="/guides/composants/" 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">Composants</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>