[{"data":1,"prerenderedAt":1419},["ShallowReactive",2],{"duxt-navigation-docs-docs_fr":3,"i-lucide:rocket":833,"i-lucide:compass":838,"i-lucide:list":840,"i-lucide:ruler":842,"i-lucide:gavel":844,"i-lucide:book-open":846,"i-lucide:folder-git":848,"i-lucide:git-compare":850,"i-lucide:languages":852,"i-lucide:palette":854,"i-lucide:signpost":856,"i-lucide:cloud-upload":858,"i-lucide:thumbs-up":860,"i-lucide:badge-check":862,"i-lucide:menu":864,"i-lucide:chevron-down":866,"i-lucide:search":868,"i-simple-icons:github":870,"i-flag:fr-4x3":872,"i-lucide:moon":876,"docs-fr-FR-\u002Fguides\u002Fseveral-languages":878,"i-lucide:copy":1388,"i-lucide:thumbs-down":1390,"i-lucide:star":1392,"i-lucide:circle-alert":1394,"i-simple-icons:discord":1396,"i-lucide:book-open-text":1398,"i-lucide:arrow-up-right":1400,"i-lucide:pencil":1402,"duxt-code-ts-locales: ['en-GB', 'fr-FR']\n":785,"duxt-code-ts-sections: [\n  {\n    label: { 'en-GB': 'Guides', 'fr-FR': 'Guides' },\n    to: '\u002Fguides',\n    icon: 'lucide:book-open'\n  }\n]\n":785,"i-lucide:folder-tree":1404,"i-lucide:chevron-right":1406,"i-lucide:folder-open":1408,"i-vscode-icons:file-type-markdown":1410,"duxt-code-ts-{\n  path: 'docs',\n  locales: ['en-GB', 'fr'],\n  refs: [\n    { tag: 'v2.0.0' },                     \u002F\u002F les deux langues\n    { tag: 'v1.0.0', locales: ['en-GB'] }  \u002F\u002F l’original seulement\n  ]\n}\n":785,"duxt-code-ts-locales: ['en-GB', { locale: 'fr', repo: 'acme\u002Fdocs-fr', path: 'docs' }]\n":785,"i-lucide:triangle-alert":1413,"i-lucide:arrow-left":1415,"i-lucide:arrow-right":1417,"duxt-code-ts-sources: [{ path: 'docs', locales: ['en-GB', 'fr'] }]\n":785},[4,25,94,148,744,752,772,827],{"title":5,"path":6,"stem":7,"children":8,"description":12},"Introduction","\u002Fgetting-started","1.getting-started",[9,13,19],{"title":5,"path":6,"stem":10,"icon":11,"description":12},"1.getting-started\u002Findex","lucide:rocket","Ce qu’est duxt, et ce qui arrive avec une seule ligne de configuration.",{"title":14,"path":15,"stem":16,"icon":17,"description":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F1.installation","lucide:download","Ajoutez la couche, étendez-la, écrivez du Markdown.",{"title":20,"path":21,"stem":22,"icon":23,"description":24},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F2.configuration","lucide:settings","Un fichier configure tout le site — ce qu’il contient, et comment il fusionne.",{"title":26,"path":27,"stem":28,"children":29,"description":33},"Concepts","\u002Fconcepts","2.concepts",[30,34,40,46,52,58,64,70,76,82,88],{"title":26,"path":27,"stem":31,"icon":32,"description":33},"2.concepts\u002Findex","lucide:compass","Comment fonctionne la couche — le modèle de sources, le schéma d’URL, les collections et les vérifications.",{"title":35,"path":36,"stem":37,"icon":38,"description":39},"Couches et surcharge","\u002Fconcepts\u002Flayers","2.concepts\u002F1.layers","lucide:layers","Ce qu’une couche Nuxt vous donne, ce qu’elle vous retire, et quels chemins ne se résolvent pas comme ils se lisent.",{"title":41,"path":42,"stem":43,"icon":44,"description":45},"Thématisation","\u002Fconcepts\u002Ftheming","2.concepts\u002F10.theming","lucide:palette","Comment le thème est construit — des composants possédés, une couche de jetons et un mode sombre qui bascule sur une classe.",{"title":47,"path":48,"stem":49,"icon":50,"description":51},"Sources","\u002Fconcepts\u002Fsources","2.concepts\u002F2.sources","lucide:git-branch","Une liste de sources devient chaque collection, préfixe et version que le site sert.",{"title":53,"path":54,"stem":55,"icon":56,"description":57},"URL et versions","\u002Fconcepts\u002Furls-and-versions","2.concepts\u002F3.urls-and-versions","lucide:git-compare","Comment apparaissent les segments de dépôt et de version, et ce qu’on dit à un lecteur dans une ancienne version.",{"title":59,"path":60,"stem":61,"icon":62,"description":63},"Collections","\u002Fconcepts\u002Fcollections","2.concepts\u002F4.collections","lucide:database","Ce que Content construit à partir des sources, et les quatre choses qu’ajoute le schéma.",{"title":65,"path":66,"stem":67,"icon":68,"description":69},"Sections générées","\u002Fconcepts\u002Fgenerated-sections","2.concepts\u002F5.generated-sections","lucide:file-cog","Un artefact plus un type, publiés en pages — ce qu’est le registre, et les deux politiques auxquelles un type répond.",{"title":71,"path":72,"stem":73,"icon":74,"description":75},"Ce que la compilation vérifie","\u002Fconcepts\u002Fbuild-checks","2.concepts\u002F6.build-checks","lucide:shield-check","Les échecs silencieux qu’a connus cette couche, transformés en messages.",{"title":77,"path":78,"stem":79,"icon":80,"description":81},"Lecteurs machines","\u002Fconcepts\u002Fmachine-readers","2.concepts\u002F7.machine-readers","lucide:bot","Ce qu’obtient un modèle — llms.txt, le Markdown brut de n’importe quelle page et un vrai serveur MCP.",{"title":83,"path":84,"stem":85,"icon":86,"description":87},"SEO","\u002Fconcepts\u002Fseo","2.concepts\u002F8.seo","lucide:search","Ce que chaque page émet pour les robots et les cartes sociales, quel module l'écrit, et la seule valeur que la couche ne peut pas deviner.",{"title":89,"path":90,"stem":91,"icon":92,"description":93},"Localisation","\u002Fconcepts\u002Flocalisation","2.concepts\u002F9.localisation","lucide:languages","La couche fournit sept locales, et chaque chaîne configurée prend trois formes.",{"title":95,"path":96,"stem":97,"children":98,"description":102},"Guides","\u002Fguides","3.guides",[99,103,109,114,119,124,130,136,142],{"title":95,"path":96,"stem":100,"icon":101,"description":102},"3.guides\u002Findex","lucide:book-open","Une tâche par page, du début à la fin — plusieurs dépôts, plusieurs versions, plusieurs langues et un déploiement.",{"title":104,"path":105,"stem":106,"icon":107,"description":108},"Plusieurs dépôts","\u002Fguides\u002Fseveral-repositories","3.guides\u002F1.several-repositories","lucide:folder-git","Servir la documentation de plusieurs projets depuis un seul site.",{"title":110,"path":111,"stem":112,"icon":56,"description":113},"Plusieurs versions","\u002Fguides\u002Fseveral-versions","3.guides\u002F2.several-versions","Servir la même documentation sur plusieurs refs, avec un sélecteur et un bandeau.",{"title":115,"path":116,"stem":117,"icon":92,"description":118},"Plusieurs langues","\u002Fguides\u002Fseveral-languages","3.guides\u002F3.several-languages","Servir l’interface en plusieurs langues, et traduire les pages elles-mêmes.",{"title":120,"path":121,"stem":122,"icon":44,"description":123},"Surcharger le thème","\u002Fguides\u002Foverride-the-theme","3.guides\u002F4.override-the-theme","Changer une couleur, remplacer un composant, ajouter une primitive shadcn-vue.",{"title":125,"path":126,"stem":127,"icon":128,"description":129},"Déplacer une page","\u002Fguides\u002Fmove-a-page","3.guides\u002F5.move-a-page","lucide:signpost","redirectFrom dans le frontmatter, transformé en règles de route sous chaque préfixe.",{"title":131,"path":132,"stem":133,"icon":134,"description":135},"Déployer un site","\u002Fguides\u002Fdeploy-a-site","3.guides\u002F6.deploy-a-site","lucide:cloud-upload","Où un site duxt peut tourner, ce qu’il lui faut là-bas, et pourquoi le contenu n’est pas rafraîchi à l’exécution.",{"title":137,"path":138,"stem":139,"icon":140,"description":141},"Recueillir des retours","\u002Fguides\u002Fcollect-page-feedback","3.guides\u002F7.collect-page-feedback","lucide:thumbs-up","Enveloppez DuxtPageFeedback et gardez la réponse là où vit déjà votre analytique.",{"title":143,"path":144,"stem":145,"icon":146,"description":147},"Donner son identité à votre site","\u002Fguides\u002Fbrand-your-site","3.guides\u002F8.brand-your-site","lucide:badge-check","Définir le nom, le logo et les icônes, pour que le site se lise comme le vôtre et non comme celui de la couche.",{"title":149,"path":150,"stem":151,"children":152,"description":156},"Référence","\u002Freference","4.reference",[153,157,161,193,197,203,343,490,612,657,717],{"title":149,"path":150,"stem":154,"icon":155,"description":156},"4.reference\u002Findex","lucide:list","La surface publique de la couche — clés de configuration, frontmatter, composants, composables et points de terminaison.",{"title":20,"path":158,"stem":159,"icon":23,"description":160},"\u002Freference\u002Fconfiguration","4.reference\u002F1.configuration","Chaque clé sous duxt dans app.config.ts — ce qu’elle contrôle, et quand elle est lue.",{"title":162,"path":163,"stem":164,"children":165,"icon":167,"description":168},"Journal des versions","\u002Freference\u002Fchangelog","4.reference\u002F10.changelog\u002Findex",[166,169,175,181,187],{"title":162,"path":163,"stem":164,"icon":167,"description":168},"lucide:tag","Un journal de releases, publié en pages — une chronologie, une page par version, et un flux.",{"title":170,"path":171,"stem":172,"icon":173,"description":174},"Déclarer la section","\u002Freference\u002Fchangelog\u002Fsection","4.reference\u002F10.changelog\u002F1.section","lucide:file-clock","Le type de section `changelog` — où vit le fichier, et les deux politiques auxquelles il répond.",{"title":176,"path":177,"stem":178,"icon":179,"description":180},"Granularité","\u002Freference\u002Fchangelog\u002Fgranularity","4.reference\u002F10.changelog\u002F2.granularity","lucide:split","Une page par version, ou le fichier comme l’unique page qu’il a été écrit.",{"title":182,"path":183,"stem":184,"icon":185,"description":186},"Ce qui est lu","\u002Freference\u002Fchangelog\u002Fwhat-is-read","4.reference\u002F10.changelog\u002F3.what-is-read","lucide:scan-text","Quels titres deviennent des versions, lesquels des groupes, et ce qu’il advient du reste.",{"title":188,"path":189,"stem":190,"icon":191,"description":192},"Mise en page et composants","\u002Freference\u002Fchangelog\u002Fcomponents","4.reference\u002F10.changelog\u002F4.components","lucide:box","La mise en page dans laquelle se rend un historique éclaté, et les deux composants MDC dont ses pages sont faites.",{"title":47,"path":194,"stem":195,"icon":50,"description":196},"\u002Freference\u002Fsources","4.reference\u002F2.sources","Les champs d’une entrée de source, ses refs, et les options qui façonnent les URL.",{"title":198,"path":199,"stem":200,"icon":201,"description":202},"Frontmatter","\u002Freference\u002Ffrontmatter","4.reference\u002F3.frontmatter","lucide:file-code","Les champs qu’une page peut porter au-delà du titre et de la description, et les deux que la compilation remplit.",{"title":204,"path":205,"stem":206,"children":207,"icon":209,"description":210},"Composants MDC","\u002Freference\u002Fmdc-components","4.reference\u002F4.mdc-components\u002Findex",[208,211,217,223,229,235,241,247,253,259,297,303,308,314,320,326,332,338],{"title":204,"path":205,"stem":206,"icon":209,"description":210},"lucide:blocks","Les blocs qu’une page Markdown peut appeler, une page chacun, avec leurs props.",{"title":212,"path":213,"stem":214,"icon":215,"description":216},"Callout","\u002Freference\u002Fmdc-components\u002Fcallout","4.reference\u002F4.mdc-components\u002F1.callout","lucide:message-square-warning","Un encadré où le lecteur est censé s’arrêter — une astuce, un avertissement, un danger.",{"title":218,"path":219,"stem":220,"icon":221,"description":222},"Gestionnaires de paquets","\u002Freference\u002Fmdc-components\u002Fpackage-managers","4.reference\u002F4.mdc-components\u002F10.package-managers","lucide:package","Une commande, un onglet par gestionnaire de paquets, mémorisé d’une page à l’autre.",{"title":224,"path":225,"stem":226,"icon":227,"description":228},"Arborescence de fichiers","\u002Freference\u002Fmdc-components\u002Ffile-tree","4.reference\u002F4.mdc-components\u002F11.file-tree","lucide:folder-tree","Une structure de dossiers, avec une icône par type de fichier.",{"title":230,"path":231,"stem":232,"icon":233,"description":234},"Aperçu","\u002Freference\u002Fmdc-components\u002Fpreview","4.reference\u002F4.mdc-components\u002F12.preview","lucide:eye","Un composant rendu tel que la page le rend, avec sa source à côté.",{"title":236,"path":237,"stem":238,"icon":239,"description":240},"Cartes de page","\u002Freference\u002Fmdc-components\u002Fpage-cards","4.reference\u002F4.mdc-components\u002F13.page-cards","lucide:layout-grid","Les enfants d’une section, en cartes.",{"title":242,"path":243,"stem":244,"icon":245,"description":246},"Partial","\u002Freference\u002Fmdc-components\u002Fpartial","4.reference\u002F4.mdc-components\u002F14.partial","lucide:puzzle","Un bloc écrit une fois et rendu dans chaque source qui en a besoin.",{"title":248,"path":249,"stem":250,"icon":251,"description":252},"Since","\u002Freference\u002Fmdc-components\u002Fsince","4.reference\u002F4.mdc-components\u002F15.since","lucide:milestone","La version dans laquelle une chose est arrivée, à côté d’un titre.",{"title":254,"path":255,"stem":256,"icon":257,"description":258},"Mermaid","\u002Freference\u002Fmdc-components\u002Fmermaid","4.reference\u002F4.mdc-components\u002F16.mermaid","lucide:workflow","Un diagramme depuis un bloc ou une prop.",{"title":260,"path":261,"stem":262,"children":263,"icon":265,"description":266},"Surcharges de prose","\u002Freference\u002Fmdc-components\u002Fprose","4.reference\u002F4.mdc-components\u002F17.prose\u002Findex",[264,267,273,279,285,291],{"title":260,"path":261,"stem":262,"icon":265,"description":266},"lucide:type","Ce que la couche change au Markdown ordinaire — liens, titres, images, code et tableaux.",{"title":268,"path":269,"stem":270,"icon":271,"description":272},"ProseA","\u002Freference\u002Fmdc-components\u002Fprose\u002Fprose-a","4.reference\u002F4.mdc-components\u002F17.prose\u002F1.prose-a","lucide:link","Un lien, résolu selon la source dans laquelle il a été écrit.",{"title":274,"path":275,"stem":276,"icon":277,"description":278},"ProseH2, ProseH3, ProseH4","\u002Freference\u002Fmdc-components\u002Fprose\u002Fprose-headings","4.reference\u002F4.mdc-components\u002F17.prose\u002F2.prose-headings","lucide:heading","Des titres, chacun avec une ancre de permalien.",{"title":280,"path":281,"stem":282,"icon":283,"description":284},"ProseImg","\u002Freference\u002Fmdc-components\u002Fprose\u002Fprose-img","4.reference\u002F4.mdc-components\u002F17.prose\u002F3.prose-img","lucide:image","Une image : qui suit le thème, et zoomable.",{"title":286,"path":287,"stem":288,"icon":289,"description":290},"ProsePre","\u002Freference\u002Fmdc-components\u002Fprose\u002Fprose-pre","4.reference\u002F4.mdc-components\u002F17.prose\u002F4.prose-pre","lucide:terminal","Le bloc de code : nom de fichier, icône de langage, bouton de copie.",{"title":292,"path":293,"stem":294,"icon":295,"description":296},"ProseTable","\u002Freference\u002Fmdc-components\u002Fprose\u002Fprose-table","4.reference\u002F4.mdc-components\u002F17.prose\u002F5.prose-table","lucide:table","Un tableau qui défile à la place de la page.",{"title":298,"path":299,"stem":300,"icon":301,"description":302},"Étapes","\u002Freference\u002Fmdc-components\u002Fsteps","4.reference\u002F4.mdc-components\u002F2.steps","lucide:list-ordered","Une liste ordonnée dessinée en étapes numérotées sur un rail.",{"title":304,"path":305,"stem":306,"icon":201,"description":307},"Groupe de code","\u002Freference\u002Fmdc-components\u002Fcode-group","4.reference\u002F4.mdc-components\u002F3.code-group","Plusieurs blocs de code en un seul bloc à onglets, étiquetés par nom de fichier.",{"title":309,"path":310,"stem":311,"icon":312,"description":313},"Groupe d'onglets","\u002Freference\u002Fmdc-components\u002Ftab-group","4.reference\u002F4.mdc-components\u002F4.tab-group","lucide:panels-top-left","Des onglets pour tout ce qui n’est pas du code.",{"title":315,"path":316,"stem":317,"icon":318,"description":319},"Tab","\u002Freference\u002Fmdc-components\u002Ftab","4.reference\u002F4.mdc-components\u002F5.tab","lucide:square","Un panneau d’un groupe d’onglets.",{"title":321,"path":322,"stem":323,"icon":324,"description":325},"Accordion","\u002Freference\u002Fmdc-components\u002Faccordion","4.reference\u002F4.mdc-components\u002F6.accordion","lucide:chevrons-up-down","Des sections repliables — une FAQ, ou des réponses parmi lesquelles le lecteur choisit.",{"title":327,"path":328,"stem":329,"icon":330,"description":331},"Élément d'accordéon","\u002Freference\u002Fmdc-components\u002Faccordion-item","4.reference\u002F4.mdc-components\u002F7.accordion-item","lucide:chevron-down","Une section repliable.",{"title":333,"path":334,"stem":335,"icon":336,"description":337},"Groupe de champs","\u002Freference\u002Fmdc-components\u002Ffield-group","4.reference\u002F4.mdc-components\u002F8.field-group","lucide:list-tree","Une liste de champs, en un seul bloc.",{"title":339,"path":340,"stem":341,"icon":167,"description":342},"Champ","\u002Freference\u002Fmdc-components\u002Ffield","4.reference\u002F4.mdc-components\u002F9.field","Un paramètre, une propriété ou une option, avec son type et sa valeur par défaut.",{"title":344,"path":345,"stem":346,"children":347,"icon":349,"description":350},"Composants","\u002Freference\u002Fcomponents","4.reference\u002F5.components\u002Findex",[348,351,371,412,459],{"title":344,"path":345,"stem":346,"icon":349,"description":350},"lucide:component","Les composants propres à la couche, une page chacun — à quoi sert chacun, et ce qu’il prend.",{"title":352,"path":353,"stem":354,"children":355,"icon":357,"description":358},"Mise en page","\u002Freference\u002Fcomponents\u002Flayout","4.reference\u002F5.components\u002F1.layout\u002Findex",[356,359,365],{"title":352,"path":353,"stem":354,"icon":357,"description":358},"lucide:layout-panel-top","Les deux composants qui encadrent une page — la barre de navigation et le pied de page.",{"title":360,"path":361,"stem":362,"icon":363,"description":364},"DuxtHeader","\u002Freference\u002Fcomponents\u002Flayout\u002Fduxt-header","4.reference\u002F5.components\u002F1.layout\u002F1.duxt-header","lucide:panel-top","La barre de navigation : titre, navigation, recherche et liens en icônes.",{"title":366,"path":367,"stem":368,"icon":369,"description":370},"DuxtFooter","\u002Freference\u002Fcomponents\u002Flayout\u002Fduxt-footer","4.reference\u002F5.components\u002F1.layout\u002F2.duxt-footer","lucide:panel-bottom","Le pied de page : le nom du site, ses liens légaux, et la ligne propre à la couche.",{"title":372,"path":373,"stem":374,"children":375,"icon":32,"description":377},"Navigation","\u002Freference\u002Fcomponents\u002Fnavigation","4.reference\u002F5.components\u002F2.navigation\u002Findex",[376,378,384,389,395,401,406],{"title":372,"path":373,"stem":374,"icon":32,"description":377},"Se déplacer — la rangée des sections, la barre latérale, le fil d’Ariane, le sommaire et précédent\u002Fsuivant.",{"title":379,"path":380,"stem":381,"icon":382,"description":383},"DuxtSections","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-sections","4.reference\u002F5.components\u002F2.navigation\u002F1.duxt-sections","lucide:rows-3","La deuxième rangée de la barre de navigation — les parties de premier niveau de la documentation.",{"title":385,"path":386,"stem":387,"icon":336,"description":388},"DuxtNavigation","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-navigation","4.reference\u002F5.components\u002F2.navigation\u002F2.duxt-navigation","L’arbre de la barre latérale.",{"title":390,"path":391,"stem":392,"icon":393,"description":394},"DuxtNavigationLink","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-navigation-link","4.reference\u002F5.components\u002F2.navigation\u002F3.duxt-navigation-link","lucide:link-2","Une entrée de la barre latérale.",{"title":396,"path":397,"stem":398,"icon":399,"description":400},"DuxtBreadcrumb","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-breadcrumb","4.reference\u002F5.components\u002F2.navigation\u002F4.duxt-breadcrumb","lucide:chevrons-right","Le fil au-dessus du titre de page.",{"title":402,"path":403,"stem":404,"icon":155,"description":405},"DuxtToc","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-toc","4.reference\u002F5.components\u002F2.navigation\u002F5.duxt-toc","Le sommaire, et l’encart en dessous.",{"title":407,"path":408,"stem":409,"icon":410,"description":411},"DuxtPageNav","\u002Freference\u002Fcomponents\u002Fnavigation\u002Fduxt-page-nav","4.reference\u002F5.components\u002F2.navigation\u002F6.duxt-page-nav","lucide:arrow-left-right","Précédent et suivant, bornés par la section.",{"title":413,"path":414,"stem":415,"children":416,"icon":418,"description":419},"Contrôles","\u002Freference\u002Fcomponents\u002Fcontrols","4.reference\u002F5.components\u002F3.controls\u002Findex",[417,420,425,430,436,441,447,453],{"title":413,"path":414,"stem":415,"icon":418,"description":419},"lucide:sliders-horizontal","Ce qu’actionne un lecteur — la recherche, les sélecteurs, la fiche des raccourcis et deux indicateurs.",{"title":421,"path":422,"stem":423,"icon":86,"description":424},"DuxtSearch","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-search","4.reference\u002F5.components\u002F3.controls\u002F1.duxt-search","La recherche sur toutes les sources, avec des résultats classés ensemble.",{"title":426,"path":427,"stem":428,"icon":38,"description":429},"DuxtVersion","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-version","4.reference\u002F5.components\u002F3.controls\u002F2.duxt-version","Le badge de version, et le sélecteur quand il y en a plusieurs.",{"title":431,"path":432,"stem":433,"icon":434,"description":435},"DuxtVersionBanner","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-version-banner","4.reference\u002F5.components\u002F3.controls\u002F3.duxt-version-banner","lucide:triangle-alert","Le bandeau qui dit au lecteur que cette version n’est pas la version courante.",{"title":437,"path":438,"stem":439,"icon":92,"description":440},"DuxtLocale","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-locale","4.reference\u002F5.components\u002F3.controls\u002F4.duxt-locale","Le sélecteur de langue.",{"title":442,"path":443,"stem":444,"icon":445,"description":446},"DuxtProgress","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-progress","4.reference\u002F5.components\u002F3.controls\u002F5.duxt-progress","lucide:loader","Jusqu’où le lecteur est descendu dans la page.",{"title":448,"path":449,"stem":450,"icon":451,"description":452},"DuxtShortcuts","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-shortcuts","4.reference\u002F5.components\u002F3.controls\u002F6.duxt-shortcuts","lucide:keyboard","La fiche des raccourcis clavier, sur ?.",{"title":454,"path":455,"stem":456,"icon":457,"description":458},"DuxtSkipLink","\u002Freference\u002Fcomponents\u002Fcontrols\u002Fduxt-skip-link","4.reference\u002F5.components\u002F3.controls\u002F7.duxt-skip-link","lucide:skip-forward","Le premier élément focalisable de la page.",{"title":460,"path":461,"stem":462,"children":463,"icon":465,"description":466},"Page","\u002Freference\u002Fcomponents\u002Fpage","4.reference\u002F5.components\u002F4.page\u002Findex",[464,467,473,479,484],{"title":460,"path":461,"stem":462,"icon":465,"description":466},"lucide:file-text","Les composants qui appartiennent à la page elle-même.",{"title":468,"path":469,"stem":470,"icon":471,"description":472},"DuxtPageInfo","\u002Freference\u002Fcomponents\u002Fpage\u002Fduxt-page-info","4.reference\u002F5.components\u002F4.page\u002F1.duxt-page-info","lucide:git-commit-horizontal","D’où vient la page : lien d’édition, dernière mise à jour, contributeurs.",{"title":474,"path":475,"stem":476,"icon":477,"description":478},"DuxtCopyPage","\u002Freference\u002Fcomponents\u002Fpage\u002Fduxt-copy-page","4.reference\u002F5.components\u002F4.page\u002F2.duxt-copy-page","lucide:clipboard-copy","Donnez cette page à un modèle, ou lisez sa source.",{"title":480,"path":481,"stem":482,"icon":140,"description":483},"DuxtPageFeedback","\u002Freference\u002Fcomponents\u002Fpage\u002Fduxt-page-feedback","4.reference\u002F5.components\u002F4.page\u002F3.duxt-page-feedback","« Cette page vous a-t-elle été utile ? » — un événement, et pas de backend.",{"title":485,"path":486,"stem":487,"icon":488,"description":489},"DuxtCodeBlock","\u002Freference\u002Fcomponents\u002Fpage\u002Fduxt-code-block","4.reference\u002F5.components\u002F4.page\u002F4.duxt-code-block","lucide:code","La carte autour d’un bloc de code.",{"title":491,"path":492,"stem":493,"children":494,"icon":496,"description":497},"Composables","\u002Freference\u002Fcomposables","4.reference\u002F6.composables\u002Findex",[495,498,532,561],{"title":491,"path":492,"stem":493,"icon":496,"description":497},"lucide:function-square","Les fonctions que la couche expose à vos propres composants, une page chacune.",{"title":499,"path":500,"stem":501,"children":502,"icon":62,"description":504},"Configuration et contenu","\u002Freference\u002Fcomposables\u002Fconfig-and-content","4.reference\u002F6.composables\u002F1.config-and-content\u002Findex",[503,505,510,516,521,527],{"title":499,"path":500,"stem":501,"icon":62,"description":504},"La configuration fusionnée, et quelle collection sert la page en cours de lecture.",{"title":506,"path":507,"stem":508,"icon":23,"description":509},"useDuxtConfig()","\u002Freference\u002Fcomposables\u002Fconfig-and-content\u002Fuse-duxt-config","4.reference\u002F6.composables\u002F1.config-and-content\u002F1.use-duxt-config","La configuration fusionnée, chaque champ de texte déjà résolu.",{"title":511,"path":512,"stem":513,"icon":514,"description":515},"useDuxtCollection()","\u002Freference\u002Fcomposables\u002Fconfig-and-content\u002Fuse-duxt-collection","4.reference\u002F6.composables\u002F1.config-and-content\u002F2.use-duxt-collection","lucide:library","Quelle collection sert cette route.",{"title":517,"path":518,"stem":519,"icon":336,"description":520},"useDuxtNavigation()","\u002Freference\u002Fcomposables\u002Fconfig-and-content\u002Fuse-duxt-navigation","4.reference\u002F6.composables\u002F1.config-and-content\u002F3.use-duxt-navigation","L’arbre de navigation de la collection qui sert cette route.",{"title":522,"path":523,"stem":524,"icon":525,"description":526},"useDuxtSection()","\u002Freference\u002Fcomposables\u002Fconfig-and-content\u002Fuse-duxt-section","4.reference\u002F6.composables\u002F1.config-and-content\u002F4.use-duxt-section","lucide:folder-open","La partie de la documentation dans laquelle se trouve cette page.",{"title":528,"path":529,"stem":530,"icon":399,"description":531},"useDuxtBreadcrumb()","\u002Freference\u002Fcomposables\u002Fconfig-and-content\u002Fuse-duxt-breadcrumb","4.reference\u002F6.composables\u002F1.config-and-content\u002F5.use-duxt-breadcrumb","Le fil qui descend de la section jusqu’à une page.",{"title":533,"path":534,"stem":535,"children":536,"icon":538,"description":539},"Chemins et versions","\u002Freference\u002Fcomposables\u002Fpaths-and-versions","4.reference\u002F6.composables\u002F2.paths-and-versions\u002Findex",[537,540,545,550,555],{"title":533,"path":534,"stem":535,"icon":538,"description":539},"lucide:route","Lire une URL, en écrire une en retour, et savoir quelle version est lue.",{"title":541,"path":542,"stem":543,"icon":251,"description":544},"useDuxtPath()","\u002Freference\u002Fcomposables\u002Fpaths-and-versions\u002Fuse-duxt-path","4.reference\u002F6.composables\u002F2.paths-and-versions\u002F1.use-duxt-path","Le chemin où se trouve la documentation, locale retirée.",{"title":546,"path":547,"stem":548,"icon":271,"description":549},"useDuxtLink()","\u002Freference\u002Fcomposables\u002Fpaths-and-versions\u002Fuse-duxt-link","4.reference\u002F6.composables\u002F2.paths-and-versions\u002F2.use-duxt-link","Un chemin de documentation, réécrit en lien.",{"title":551,"path":552,"stem":553,"icon":38,"description":554},"useDuxtVersion()","\u002Freference\u002Fcomposables\u002Fpaths-and-versions\u002Fuse-duxt-version","4.reference\u002F6.composables\u002F2.paths-and-versions\u002F3.use-duxt-version","Ce que montre le sélecteur, ce que dit la bannière, s’il faut indexer.",{"title":556,"path":557,"stem":558,"icon":559,"description":560},"useDuxtSiteUrl()","\u002Freference\u002Fcomposables\u002Fpaths-and-versions\u002Fuse-duxt-site-url","4.reference\u002F6.composables\u002F2.paths-and-versions\u002F4.use-duxt-site-url","lucide:globe","L’origine configurée, et les chemins rendus absolus.",{"title":562,"path":563,"stem":564,"children":565,"icon":101,"description":567},"Expérience de lecture","\u002Freference\u002Fcomposables\u002Freading","4.reference\u002F6.composables\u002F3.reading\u002Findex",[566,568,573,579,584,590,596,601,607],{"title":562,"path":563,"stem":564,"icon":101,"description":567},"La recherche, les titres, le focus, l’historique, et les choix que fait un lecteur.",{"title":569,"path":570,"stem":571,"icon":86,"description":572},"useDuxtSearch()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-search","4.reference\u002F6.composables\u002F3.reading\u002F1.use-duxt-search","La recherche sur toutes les sources, classées ensemble.",{"title":574,"path":575,"stem":576,"icon":577,"description":578},"useFuzzySearch()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-fuzzy-search","4.reference\u002F6.composables\u002F3.reading\u002F2.use-fuzzy-search","lucide:spell-check","La tolérance aux fautes de frappe, à côté de l’index exact.",{"title":580,"path":581,"stem":582,"icon":277,"description":583},"useActiveHeading()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-active-heading","4.reference\u002F6.composables\u002F3.reading\u002F3.use-active-heading","Le titre actuellement en vue.",{"title":585,"path":586,"stem":587,"icon":588,"description":589},"useDuxtPageFocus()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-page-focus","4.reference\u002F6.composables\u002F3.reading\u002F4.use-duxt-page-focus","lucide:focus","Déplace le focus vers le titre après une navigation côté client.",{"title":591,"path":592,"stem":593,"icon":594,"description":595},"useRecentPages()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-recent-pages","4.reference\u002F6.composables\u002F3.reading\u002F5.use-recent-pages","lucide:history","Les cinq dernières pages que ce lecteur a ouvertes.",{"title":597,"path":598,"stem":599,"icon":221,"description":600},"usePackageManager()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-package-manager","4.reference\u002F6.composables\u002F3.reading\u002F6.use-package-manager","Le gestionnaire de paquets qu’un lecteur a choisi.",{"title":602,"path":603,"stem":604,"icon":605,"description":606},"useDuxtToast()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-toast","4.reference\u002F6.composables\u002F3.reading\u002F7.use-duxt-toast","lucide:bell","Les notifications, enveloppées pour qu’aucun composant n’importe la bibliothèque.",{"title":608,"path":609,"stem":610,"icon":451,"description":611},"useDuxtShortcuts()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-shortcuts","4.reference\u002F6.composables\u002F3.reading\u002F8.use-duxt-shortcuts","Les touches que le thème écoute.",{"title":613,"path":614,"stem":615,"children":616,"icon":538,"description":618},"Points de terminaison","\u002Freference\u002Fendpoints","4.reference\u002F7.endpoints\u002Findex",[617,619,624,630,635,640,645,651],{"title":613,"path":614,"stem":615,"icon":538,"description":618},"Tout ce que le site sert en dehors des pages, une page pour chacun.",{"title":620,"path":621,"stem":622,"icon":465,"description":623},"\u002Fllms.txt","\u002Freference\u002Fendpoints\u002Fllms-txt","4.reference\u002F7.endpoints\u002F1.llms-txt","La documentation en index Markdown, selon llmstxt.org.",{"title":625,"path":626,"stem":627,"icon":628,"description":629},"\u002Fllms-full.txt","\u002Freference\u002Fendpoints\u002Fllms-full-txt","4.reference\u002F7.endpoints\u002F2.llms-full-txt","lucide:file-stack","Les mêmes pages, entières, en un seul fichier Markdown.",{"title":631,"path":632,"stem":633,"icon":201,"description":634},"\u003Cpage>.md","\u002Freference\u002Fendpoints\u002Fpage-markdown","4.reference\u002F7.endpoints\u002F3.page-markdown","La source de n’importe quelle page, à son URL suivie de .md.",{"title":636,"path":637,"stem":638,"icon":80,"description":639},"\u002Fmcp","\u002Freference\u002Fendpoints\u002Fmcp","4.reference\u002F7.endpoints\u002F4.mcp","Un serveur MCP sur le même contenu.",{"title":641,"path":642,"stem":643,"icon":86,"description":644},"\u002Fsitemap.xml et \u002Frobots.txt","\u002Freference\u002Fendpoints\u002Fsitemap-and-robots","4.reference\u002F7.endpoints\u002F5.sitemap-and-robots","Ce vers quoi un robot est dirigé, et ce dont on le tient à l’écart.",{"title":646,"path":647,"stem":648,"icon":649,"description":650},"\u002Frss.xml","\u002Freference\u002Fendpoints\u002Frss-xml","4.reference\u002F7.endpoints\u002F6.rss-xml","lucide:rss","Le flux, une fois qu’une section est nommée.",{"title":652,"path":653,"stem":654,"icon":655,"description":656},"\u002F_duxt\u002Fdevtools","\u002Freference\u002Fendpoints\u002Fdevtools","4.reference\u002F7.endpoints\u002F7.devtools","lucide:wrench","La route depuis laquelle le panneau Nuxt Devtools est servi. En développement seulement.",{"title":658,"path":659,"stem":660,"children":661,"icon":655,"description":663},"Devtools","\u002Freference\u002Fdevtools","4.reference\u002F8.devtools\u002Findex",[662,664,668,673,678,684,690,696,701,706,711],{"title":658,"path":659,"stem":660,"icon":655,"description":663},"Dix panneaux qui montrent ce que vos sources sont devenues. En développement seulement.",{"title":47,"path":665,"stem":666,"icon":514,"description":667},"\u002Freference\u002Fdevtools\u002Fsources","4.reference\u002F8.devtools\u002F1.sources","Ce que `duxt.sources` est devenu — une collection par source, version et langue.",{"title":669,"path":670,"stem":671,"icon":128,"description":672},"Redirections","\u002Freference\u002Fdevtools\u002Fredirects","4.reference\u002F8.devtools\u002F10.redirects","Chaque redirection que sert le serveur, et lesquelles la couche a écrites.",{"title":674,"path":675,"stem":676,"icon":538,"description":677},"Chemins","\u002Freference\u002Fdevtools\u002Fpaths","4.reference\u002F8.devtools\u002F2.paths","Collez une URL et voyez quelle source la revendique et ce qu’elle y trouve.",{"title":679,"path":680,"stem":681,"icon":682,"description":683},"Pages","\u002Freference\u002Fdevtools\u002Fpages","4.reference\u002F8.devtools\u002F3.pages","lucide:files","Chaque page de chaque collection, avec son frontmatter et ses métadonnées git.",{"title":685,"path":686,"stem":687,"icon":688,"description":689},"Versions","\u002Freference\u002Fdevtools\u002Fversions","4.reference\u002F8.devtools\u002F4.versions","lucide:columns-3","Quelle version — et quelle langue — porte quelle page.",{"title":691,"path":692,"stem":693,"icon":694,"description":695},"Vérifications","\u002Freference\u002Fdevtools\u002Fchecks","4.reference\u002F8.devtools\u002F5.checks","lucide:check-check","Le validateur du build, appliqué à ce que le site sert en ce moment.",{"title":697,"path":698,"stem":699,"icon":86,"description":700},"Recherche","\u002Freference\u002Fdevtools\u002Fsearch","4.reference\u002F8.devtools\u002F6.search","Ce que contient l’index de recherche, via la requête même que lance la boîte de dialogue.",{"title":702,"path":703,"stem":704,"icon":418,"description":705},"Config","\u002Freference\u002Fdevtools\u002Fconfig","4.reference\u002F8.devtools\u002F7.config","La configuration `duxt` fusionnée, et de quel côté de la fusion vient chaque valeur.",{"title":707,"path":708,"stem":709,"icon":92,"description":710},"i18n","\u002Freference\u002Fdevtools\u002Fi18n","4.reference\u002F8.devtools\u002F8.i18n","Clés de message par langue, face à la langue de base.",{"title":712,"path":713,"stem":714,"icon":715,"description":716},"Cache","\u002Freference\u002Fdevtools\u002Fcache","4.reference\u002F8.devtools\u002F9.cache","lucide:hard-drive","Le cache de téléchargement de Content, et un moyen d’en jeter une entrée.",{"title":718,"path":719,"stem":720,"children":721,"icon":723,"description":724},"Référence de l’API","\u002Freference\u002Fopenapi","4.reference\u002F9.openapi\u002Findex",[722,725,729,733,739],{"title":718,"path":719,"stem":720,"icon":723,"description":724},"lucide:plug","Un document OpenAPI, publié en pages de référence avec un client qui envoie de vraies requêtes.",{"title":170,"path":726,"stem":727,"icon":201,"description":728},"\u002Freference\u002Fopenapi\u002Fsection","4.reference\u002F9.openapi\u002F1.section","Le type de section `openapi` — où vit le document, et ce qu’il devient.",{"title":344,"path":730,"stem":731,"icon":191,"description":732},"\u002Freference\u002Fopenapi\u002Fcomponents","4.reference\u002F9.openapi\u002F2.components","Les trois composants MDC dont est faite une page de référence générée.",{"title":734,"path":735,"stem":736,"icon":737,"description":738},"Le client d’essai","\u002Freference\u002Fopenapi\u002Ftry-it","4.reference\u002F9.openapi\u002F3.try-it","lucide:send","Une vraie requête, envoyée par le navigateur du lecteur lui-même.",{"title":740,"path":741,"stem":742,"icon":488,"description":743},"Échantillons de requête","\u002Freference\u002Fopenapi\u002Frequest-samples","4.reference\u002F9.openapi\u002F4.request-samples","La même requête dans douze clients, et comment ajouter le vôtre.",{"title":745,"path":746,"stem":747,"children":748,"icon":750,"description":751},"Crédits","\u002Fcredits","5.credits\u002Findex",[749],{"title":745,"path":746,"stem":747,"icon":750,"description":751},"lucide:heart","Ce sur quoi duxt est construit, et ce d’après quoi il l’a été.",{"title":753,"path":754,"stem":755,"children":756,"description":760},"Conventions","\u002Fconventions","6.conventions",[757,761,767],{"title":753,"path":754,"stem":758,"icon":759,"description":760},"6.conventions\u002Findex","lucide:ruler","Règles propres au projet — celles qu'on ne peut pas déduire du code.",{"title":762,"path":763,"stem":764,"icon":765,"description":766},"Identité visuelle","\u002Fconventions\u002Fbranding","6.conventions\u002F1.branding","lucide:shapes","La marque [d]uxt — où sert chaque ressource, pourquoi les crochets de l'icône sont redessinés, et quelles couleurs sont fixes.",{"title":768,"path":769,"stem":770,"icon":283,"description":771},"Icônes","\u002Fconventions\u002Ficons","6.conventions\u002F2.icons","Quatre jeux d'icônes, et la seule question qui décide lequel dessine une marque.",{"title":773,"path":774,"stem":775,"children":776,"description":780},"Décisions d’architecture","\u002Fadr","99.adr",[777,781,787,792,797,802,807,812,817,822],{"title":773,"path":774,"stem":778,"icon":779,"description":780},"99.adr\u002Findex","lucide:gavel","Le journal des décisions — chaque décision d’architecture consignée pour duxt.",{"title":782,"path":783,"stem":784,"icon":785,"description":786},"Construire duxt comme une couche portant un module","\u002Fadr\u002F0001-build-duxt-as-a-layer-carrying-a-module","99.adr\u002F0001-build-duxt-as-a-layer-carrying-a-module",null,"Distribuer le thème comme une couche Nuxt dont la racine est le paquet, plutôt que comme un modèle de départ.",{"title":788,"path":789,"stem":790,"icon":785,"description":791},"Générer les collections à partir d’une seule liste de sources","\u002Fadr\u002F0002-generate-the-collections-from-one-source-list","99.adr\u002F0002-generate-the-collections-from-one-source-list","Calculer les collections Content à partir d’une liste de sources compacte au chargement de la configuration, au lieu de les faire déclarer par les consommateurs.",{"title":793,"path":794,"stem":795,"icon":785,"description":796},"Décider les préfixes d’URL à la compilation","\u002Fadr\u002F0003-decide-the-url-prefixes-at-build-time","99.adr\u002F0003-decide-the-url-prefixes-at-build-time","L’apparition d’un segment de dépôt ou de version est tranchée par la liste des sources avant la première requête, jamais par requête.",{"title":798,"path":799,"stem":800,"icon":785,"description":801},"Rendre les composants Markdown avec MDC","\u002Fadr\u002F0004-render-markdown-components-with-mdc","99.adr\u002F0004-render-markdown-components-with-mdc","Utiliser la syntaxe MDC propre à Content pour les composants dans le Markdown plutôt que d’adopter MDX.",{"title":803,"path":804,"stem":805,"icon":785,"description":806},"Livrer la couche sans liens propres à un propriétaire","\u002Fadr\u002F0005-ship-the-layer-without-owner-specific-links","99.adr\u002F0005-ship-the-layer-without-owner-specific-links","Toute valeur par défaut qui nommerait un projet précis — dépôt, gestionnaire de tickets, communauté, mentions légales — est livrée vide.",{"title":808,"path":809,"stem":810,"icon":785,"description":811},"Recompiler de façon planifiée plutôt que rafraîchir à l’exécution","\u002Fadr\u002F0006-rebuild-on-a-schedule-rather-than-refresh-at-runtime","99.adr\u002F0006-rebuild-on-a-schedule-rather-than-refresh-at-runtime","Un site qui lit un autre dépôt en récupère les changements quand il compile, et aucun rafraîchissement à l’exécution n’est proposé.",{"title":813,"path":814,"stem":815,"icon":785,"description":816},"Servir les traductions comme des collections à part","\u002Fadr\u002F0007-serve-translations-as-collections-of-their-own","99.adr\u002F0007-serve-translations-as-collections-of-their-own","Ajouter une dimension de locale à une source plutôt qu’un segment de locale au chemin de contenu.",{"title":818,"path":819,"stem":820,"icon":785,"description":821},"Bâtir le thème sur des composants shadcn-vue possédés","\u002Fadr\u002F0008-build-the-theme-on-owned-shadcn-vue-components","99.adr\u002F0008-build-the-theme-on-owned-shadcn-vue-components","La couche détient le code source de ses composants d'interface plutôt que de les importer d'une bibliothèque de composants ou d'un thème de documentation tout fait.",{"title":823,"path":824,"stem":825,"icon":785,"description":826},"Prendre le socle SEO dans le bundle Nuxt SEO","\u002Fadr\u002F0009-take-the-seo-stack-from-the-nuxt-seo-bundle","99.adr\u002F0009-take-the-seo-stack-from-the-nuxt-seo-bundle","La couche installe @nuxtjs\u002Fseo et lui confie les balises de head et les données structurées qu'elle écrivait à la main, ne gardant que les règles qui dépendent des versions et des traductions.",{"title":828,"path":829,"stem":830,"icon":831,"description":832},"Documentation","\u002F","index","lucide:book-open-text","Une couche Nuxt qui transforme le dossier docs d’un dépôt en un site de documentation versionné et multi-dépôts.",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":837},0,24,false,"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09\"\u002F>\u003Cpath d=\"M9 12a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.4 22.4 0 0 1-4 2z\"\u002F>\u003Cpath d=\"M9 12H4s.55-3.03 2-4c1.62-1.08 5 .05 5 .05\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":839},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"m16.24 7.76l-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":841},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M3 5h.01M3 12h.01M3 19h.01M8 5h13M8 12h13M8 19h13\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":843},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M21.3 15.3a2.4 2.4 0 0 1 0 3.4l-2.6 2.6a2.4 2.4 0 0 1-3.4 0L2.7 8.7a2.41 2.41 0 0 1 0-3.4l2.6-2.6a2.41 2.41 0 0 1 3.4 0Zm-6.8-2.8l2-2m-5-1l2-2m-5-1l2-2m7 11l2-2\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":845},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m14 13l-8.381 8.38a1 1 0 0 1-3.001-3l8.384-8.381M16 16l6-6m-.5.5l-8-8M8 8l6-6M8.5 7.5l8 8\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":847},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v16m8.001-2A2 2 0 0 0 22 17V5a2 2 0 0 0-1.999-2L16 3.002A5 5 0 0 0 12 5a5 5 0 0 0-4-2H4a2 2 0 0 0-2 2v12a2 2 0 0 0 1.999 2H8a5 5 0 0 1 4 2a5 5 0 0 1 4-2z\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":849},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"13\" r=\"2\"\u002F>\u003Cpath d=\"M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Zm-6-7h3M7 13h3\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":851},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"18\" cy=\"18\" r=\"3\"\u002F>\u003Ccircle cx=\"6\" cy=\"6\" r=\"3\"\u002F>\u003Cpath d=\"M13 6h3a2 2 0 0 1 2 2v7m-7 3H8a2 2 0 0 1-2-2V9\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":853},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m5 8l6 6m-7 0l6-6l2-3M2 5h12M7 2h1m14 20l-5-10l-5 10m2-4h6\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":855},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 22a1 1 0 0 1 0-20a10 9 0 0 1 10 9a5 5 0 0 1-5 5h-2.25a1.75 1.75 0 0 0-1.4 2.8l.3.4a1.75 1.75 0 0 1-1.4 2.8z\"\u002F>\u003Ccircle cx=\"13.5\" cy=\"6.5\" r=\".5\" fill=\"currentColor\"\u002F>\u003Ccircle cx=\"17.5\" cy=\"10.5\" r=\".5\" fill=\"currentColor\"\u002F>\u003Ccircle cx=\"6.5\" cy=\"12.5\" r=\".5\" fill=\"currentColor\"\u002F>\u003Ccircle cx=\"8.5\" cy=\"7.5\" r=\".5\" fill=\"currentColor\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":857},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 13v8m0-18v3m-9.646 4.354a1.207 1.207 0 0 1 0-1.708l2.06-2.06A2 2 0 0 1 5.828 6h12.344a2 2 0 0 1 1.414.586l2.06 2.06a1.207 1.207 0 0 1 0 1.708l-2.06 2.06a2 2 0 0 1-1.414.586H5.828a2 2 0 0 1-1.414-.586z\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":859},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 13v8m-8-6.101A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242\"\u002F>\u003Cpath d=\"m8 17l4-4l4 4\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":861},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M15 5.88L14 10h5.83a2 2 0 0 1 1.92 2.56l-2.33 8A2 2 0 0 1 17.5 22H4a2 2 0 0 1-2-2v-8a2 2 0 0 1 2-2h2.76a2 2 0 0 0 1.79-1.11L12 2a3.13 3.13 0 0 1 3 3.88M7 10v12\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":863},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M3.85 8.62a4 4 0 0 1 4.78-4.77a4 4 0 0 1 6.74 0a4 4 0 0 1 4.78 4.78a4 4 0 0 1 0 6.74a4 4 0 0 1-4.77 4.78a4 4 0 0 1-6.75 0a4 4 0 0 1-4.78-4.77a4 4 0 0 1 0-6.76\"\u002F>\u003Cpath d=\"m16 9l-5.5 5.5L8 12\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":865},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":867},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":869},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m21 21l-4.34-4.34\"\u002F>\u003Ccircle cx=\"11\" cy=\"11\" r=\"8\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":871},"\u003Cpath fill=\"currentColor\" d=\"M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12\"\u002F>",{"left":834,"top":834,"width":873,"height":874,"rotate":834,"vFlip":836,"hFlip":836,"body":875},640,480,"\u003Cpath fill=\"#000091\" d=\"M0 0h213.3v480H0z\"\u002F>\u003Cpath fill=\"#fff\" d=\"M213.3 0h213.4v480H213.3z\"\u002F>\u003Cpath fill=\"#e1000f\" d=\"M426.7 0H640v480H426.7z\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":877},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401\"\u002F>",{"page":879,"from":1386,"asked":1387},{"id":880,"title":115,"body":881,"compare":785,"contributors":1376,"date":785,"description":118,"extension":1379,"icon":92,"lastUpdated":1380,"layout":785,"meta":1381,"navigation":836,"path":116,"rawbody":1382,"redirectFrom":785,"seo":1383,"sitemap":1384,"stem":117,"__hash__":1385},"docs_fr\u002F3.guides\u002F3.several-languages.md",{"type":882,"value":883,"toc":1370},"minimark",[884,888,892,1126,1130,1135,1222,1225,1257,1268,1280,1284,1298,1302,1366],[885,886,887],"p",{},"Les chaînes du thème sont traduites dans sept locales. Un site sert le\nsous-ensemble qu’il veut, traduit les chaînes qu’il a lui-même configurées et —\ns’il le souhaite — les pages aussi.",[889,890,298],"h2",{"id":891},"étapes",[893,894,895,1110,1115,1118],"steps",{},[896,897,898,956,970,1059,1075],"ol",{},[899,900,901,910,946,949,950,952,953,909],"li",{},[902,903,904,905,909],"strong",{},"Restreignez la liste avec ",[906,907,908],"code",{},"duxt.locales",".",[911,912,918],"pre",{"className":913,"code":914,"filename":915,"language":916,"meta":917,"style":917},"language-ts shiki shiki-themes github-light github-dark","locales: ['en-GB', 'fr-FR']\n","app\u002Fapp.config.ts","ts","",[906,919,920],{"__ignoreMap":917},[921,922,925,929,933,937,940,943],"span",{"class":923,"line":924},"line",1,[921,926,928],{"class":927},"sScJk","locales",[921,930,932],{"class":931},"sVt8B",": [",[921,934,936],{"class":935},"sZZnC","'en-GB'",[921,938,939],{"class":931},", ",[921,941,942],{"class":935},"'fr-FR'",[921,944,945],{"class":931},"]\n",[947,948],"br",{},"Pas le tableau ",[906,951,928],{}," d’i18n : celui-là fusionne entre les couches au lieu\nde remplacer, donc en déclarer deux là laisse les cinq autres routées et\nannoncées dans ",[906,954,955],{},"hreflang",[899,957,958,961,962,965,966,969],{},[902,959,960],{},"Choisissez celle sans préfixe"," dans ",[906,963,964],{},"nuxt.config.ts"," avec\n",[906,967,968],{},"i18n.defaultLocale",". Elle est déterminante pour les URL : la changer plus\ntard déplace toutes les pages dans les deux sens à la fois.",[899,971,972,975,976,1052,1054,1055,1058],{},[902,973,974],{},"Traduisez vos propres chaînes."," Pour une poignée, la forme\nd’enregistrement coûte moins qu’un fichier de locale par langue :",[911,977,979],{"className":913,"code":978,"language":916,"meta":917,"style":917},"sections: [\n  {\n    label: { 'en-GB': 'Guides', 'fr-FR': 'Guides' },\n    to: '\u002Fguides',\n    icon: 'lucide:book-open'\n  }\n]\n",[906,980,981,989,995,1020,1032,1041,1047],{"__ignoreMap":917},[921,982,983,986],{"class":923,"line":924},[921,984,985],{"class":927},"sections",[921,987,988],{"class":931},": [\n",[921,990,992],{"class":923,"line":991},2,[921,993,994],{"class":931},"  {\n",[921,996,998,1001,1003,1006,1009,1011,1013,1015,1017],{"class":923,"line":997},3,[921,999,1000],{"class":931},"    label: { ",[921,1002,936],{"class":935},[921,1004,1005],{"class":931},": ",[921,1007,1008],{"class":935},"'Guides'",[921,1010,939],{"class":931},[921,1012,942],{"class":935},[921,1014,1005],{"class":931},[921,1016,1008],{"class":935},[921,1018,1019],{"class":931}," },\n",[921,1021,1023,1026,1029],{"class":923,"line":1022},4,[921,1024,1025],{"class":931},"    to: ",[921,1027,1028],{"class":935},"'\u002Fguides'",[921,1030,1031],{"class":931},",\n",[921,1033,1035,1038],{"class":923,"line":1034},5,[921,1036,1037],{"class":931},"    icon: ",[921,1039,1040],{"class":935},"'lucide:book-open'\n",[921,1042,1044],{"class":923,"line":1043},6,[921,1045,1046],{"class":931},"  }\n",[921,1048,1050],{"class":923,"line":1049},7,[921,1051,945],{"class":931},[947,1053],{},"Au-delà d’une poignée, enregistrez vos propres clés i18n et écrivez la clé.\nN’allez pas chercher ",[906,1056,1057],{},"duxt.defaults.*"," — ce sont les clés internes de la\ncouche, et un renommage là-bas casserait votre site en silence.",[899,1060,1061,1064,1065,1067,1068,1071,1072,909],{},[902,1062,1063],{},"Indiquez l’origine."," ",[906,1066,955],{}," n’est pas valide en relatif : il faut donc\n",[906,1069,1070],{},"i18n.baseUrl"," ou ",[906,1073,1074],{},"NUXT_PUBLIC_I18N_BASE_URL",[899,1076,1077,1080,1081],{},[902,1078,1079],{},"Traduisez les pages, si vous le voulez."," Un dossier par langue à\nl’intérieur de la source ; la locale par défaut reste où elle est et ne\ndéplace aucune URL :",[911,1082,1084],{"className":913,"code":1083,"filename":915,"language":916,"meta":917,"style":917},"sources: [{ path: 'docs', locales: ['en-GB', 'fr'] }]\n",[906,1085,1086],{"__ignoreMap":917},[921,1087,1088,1091,1094,1097,1100,1102,1104,1107],{"class":923,"line":924},[921,1089,1090],{"class":927},"sources",[921,1092,1093],{"class":931},": [{ path: ",[921,1095,1096],{"class":935},"'docs'",[921,1098,1099],{"class":931},", locales: [",[921,1101,936],{"class":935},[921,1103,939],{"class":931},[921,1105,1106],{"class":935},"'fr'",[921,1108,1109],{"class":931},"] }]\n",[1111,1112],"file-tree",{":tree":1113,"title":1114},"[{\"name\":\"index.md\"},{\"name\":\"1.getting-started\u002F\",\"children\":[{\"name\":\"index.md\"}]},{\"name\":\"fr\u002F\",\"children\":[{\"name\":\"index.md\"}]}]","docs\u002F",[885,1116,1117],{},"Traduisez aussi peu de pages que vous voulez — tout le reste retombe sur\nl’original, avec un bandeau qui en explique la raison au lecteur.",[896,1119,1120],{"start":1043},[899,1121,1122,1125],{},[902,1123,1124],{},"Ouvrez une page dans chaque locale"," et vérifiez que l’interface a changé\nde langue, que le chemin se résout toujours et qu’aucun libellé configuré ne\ns’affiche en clé brute.",[889,1127,1129],{"id":1128},"seulement-certaines-versions-ou-un-autre-dépôt","Seulement certaines versions, ou un autre dépôt",[885,1131,1132,1134],{},[906,1133,928],{}," sur une ref l’emporte sur celui de la source, ce qui est la forme\nhabituelle : la version courante est traduite et les deux précédentes non.",[911,1136,1138],{"className":913,"code":1137,"language":916,"meta":917,"style":917},"{\n  path: 'docs',\n  locales: ['en-GB', 'fr'],\n  refs: [\n    { tag: 'v2.0.0' },                     \u002F\u002F les deux langues\n    { tag: 'v1.0.0', locales: ['en-GB'] }  \u002F\u002F l’original seulement\n  ]\n}\n",[906,1139,1140,1145,1156,1172,1179,1194,1211,1216],{"__ignoreMap":917},[921,1141,1142],{"class":923,"line":924},[921,1143,1144],{"class":931},"{\n",[921,1146,1147,1150,1152,1154],{"class":923,"line":991},[921,1148,1149],{"class":927},"  path",[921,1151,1005],{"class":931},[921,1153,1096],{"class":935},[921,1155,1031],{"class":931},[921,1157,1158,1161,1163,1165,1167,1169],{"class":923,"line":997},[921,1159,1160],{"class":927},"  locales",[921,1162,932],{"class":931},[921,1164,936],{"class":935},[921,1166,939],{"class":931},[921,1168,1106],{"class":935},[921,1170,1171],{"class":931},"],\n",[921,1173,1174,1177],{"class":923,"line":1022},[921,1175,1176],{"class":927},"  refs",[921,1178,988],{"class":931},[921,1180,1181,1184,1187,1190],{"class":923,"line":1034},[921,1182,1183],{"class":931},"    { tag: ",[921,1185,1186],{"class":935},"'v2.0.0'",[921,1188,1189],{"class":931}," },                     ",[921,1191,1193],{"class":1192},"sJ8bj","\u002F\u002F les deux langues\n",[921,1195,1196,1198,1201,1203,1205,1208],{"class":923,"line":1043},[921,1197,1183],{"class":931},[921,1199,1200],{"class":935},"'v1.0.0'",[921,1202,1099],{"class":931},[921,1204,936],{"class":935},[921,1206,1207],{"class":931},"] }  ",[921,1209,1210],{"class":1192},"\u002F\u002F l’original seulement\n",[921,1212,1213],{"class":923,"line":1049},[921,1214,1215],{"class":931},"  ]\n",[921,1217,1219],{"class":923,"line":1218},8,[921,1220,1221],{"class":931},"}\n",[885,1223,1224],{},"La forme objet déplace une langue entièrement ailleurs — son propre dépôt, avec\nses propres mainteneurs et son propre rythme :",[911,1226,1228],{"className":913,"code":1227,"language":916,"meta":917,"style":917},"locales: ['en-GB', { locale: 'fr', repo: 'acme\u002Fdocs-fr', path: 'docs' }]\n",[906,1229,1230],{"__ignoreMap":917},[921,1231,1232,1234,1236,1238,1241,1243,1246,1249,1252,1254],{"class":923,"line":924},[921,1233,928],{"class":927},[921,1235,932],{"class":931},[921,1237,936],{"class":935},[921,1239,1240],{"class":931},", { locale: ",[921,1242,1106],{"class":935},[921,1244,1245],{"class":931},", repo: ",[921,1247,1248],{"class":935},"'acme\u002Fdocs-fr'",[921,1250,1251],{"class":931},", path: ",[921,1253,1096],{"class":935},[921,1255,1256],{"class":931}," }]\n",[885,1258,1259,1260,1263,1264,1267],{},"C’est ce que font React et Vue en dehors de leur outillage, avec ",[906,1261,1262],{},"de.react.dev","\net l’organisation ",[906,1265,1266],{},"vuejs-translations",", parce que les traducteurs travaillent\nselon leur propre calendrier et leur propre relecture. Ici, c’est une entrée de\nsource plutôt qu’un second site — un index de recherche, un sélecteur de langue.",[1269,1270,1273],"callout",{"title":1271,"type":1272},"Ce que coûte une traduction à la compilation","warning",[885,1274,1275,1276,1279],{},"Environ ",[902,1277,1278],{},"deux secondes de compilation et 0,6 Mo de base de données par langue ×\nversion × dépôt",", mesuré linéaire jusqu’à au moins 200 collections. Traduire\nchaque version de chaque dépôt multiplie les trois ; ne traduire que la version\ncourante est ce que font la plupart des projets.",[889,1281,1283],{"id":1282},"quand-une-page-na-pas-de-traduction","Quand une page n’a pas de traduction",[885,1285,1286,1287,1290,1291,1294,1295,909],{},"Le lecteur reçoit la langue la plus proche qui l’a, avec un bandeau, et la page\nporte ",[906,1288,1289],{},"noindex"," ainsi qu’un canonical pointant vers la langue dans laquelle elle\nest réellement. La chaîne — locale, langue de base, région sœur,\n",[906,1292,1293],{},"fallbackLocale",", original — est dans ",[1296,1297,89],"a",{"href":90},[889,1299,1301],{"id":1300},"liste-de-contrôle","Liste de contrôle",[1303,1304,1307,1319,1328,1337,1343,1349,1355],"ul",{"className":1305},[1306],"contains-task-list",[899,1308,1311,1064,1316,1318],{"className":1309},[1310],"task-list-item",[1312,1313],"input",{"disabled":1314,"type":1315},true,"checkbox",[906,1317,908],{}," liste exactement les locales que vous servez",[899,1320,1322,1064,1324,1327],{"className":1321},[1310],[1312,1323],{"disabled":1314,"type":1315},[906,1325,1326],{},"\u002Fsitemap.xml"," contient une entrée par page et par locale, et aucune autre",[899,1329,1331,1333,1334,1336],{"className":1330},[1310],[1312,1332],{"disabled":1314,"type":1315}," Les liens ",[906,1335,955],{}," sont absolus",[899,1338,1340,1342],{"className":1339},[1310],[1312,1341],{"disabled":1314,"type":1315}," Aucun libellé configuré ne s’affiche en clé brute",[899,1344,1346,1348],{"className":1345},[1310],[1312,1347],{"disabled":1314,"type":1315}," Changer de locale garde le lecteur sur la même page",[899,1350,1352,1354],{"className":1351},[1310],[1312,1353],{"disabled":1314,"type":1315}," Une page non traduite affiche le bandeau de repli, pas un 404",[899,1356,1358,1064,1360,1363,1364],{"className":1357},[1310],[1312,1359],{"disabled":1314,"type":1315},[906,1361,1362],{},"duxt.sourceOptions.defaultLocale"," correspond à ",[906,1365,968],{},[1367,1368,1369],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":917,"searchDepth":991,"depth":991,"links":1371},[1372,1373,1374,1375],{"id":891,"depth":991,"text":298},{"id":1128,"depth":991,"text":1129},{"id":1282,"depth":991,"text":1283},{"id":1300,"depth":991,"text":1301},[1377],{"name":1378,"commits":924},"Titus Kirch","md","2026-09-06T21:35:31+02:00",{},"---\ntitle: Plusieurs langues\ndescription: Servir l’interface en plusieurs langues, et traduire les pages elles-mêmes.\nicon: lucide:languages\n---\n\nLes chaînes du thème sont traduites dans sept locales. Un site sert le\nsous-ensemble qu’il veut, traduit les chaînes qu’il a lui-même configurées et —\ns’il le souhaite — les pages aussi.\n\n## Étapes\n\n::steps\n1. **Restreignez la liste avec `duxt.locales`.**\n\n   ```ts [app\u002Fapp.config.ts]\n   locales: ['en-GB', 'fr-FR']\n   ```\n\n   Pas le tableau `locales` d’i18n : celui-là fusionne entre les couches au lieu\n   de remplacer, donc en déclarer deux là laisse les cinq autres routées et\n   annoncées dans `hreflang`.\n\n2. **Choisissez celle sans préfixe** dans `nuxt.config.ts` avec\n   `i18n.defaultLocale`. Elle est déterminante pour les URL : la changer plus\n   tard déplace toutes les pages dans les deux sens à la fois.\n\n3. **Traduisez vos propres chaînes.** Pour une poignée, la forme\n   d’enregistrement coûte moins qu’un fichier de locale par langue :\n\n   ```ts\n   sections: [\n     {\n       label: { 'en-GB': 'Guides', 'fr-FR': 'Guides' },\n       to: '\u002Fguides',\n       icon: 'lucide:book-open'\n     }\n   ]\n   ```\n\n   Au-delà d’une poignée, enregistrez vos propres clés i18n et écrivez la clé.\n   N’allez pas chercher `duxt.defaults.*` — ce sont les clés internes de la\n   couche, et un renommage là-bas casserait votre site en silence.\n\n4. **Indiquez l’origine.** `hreflang` n’est pas valide en relatif : il faut donc\n   `i18n.baseUrl` ou `NUXT_PUBLIC_I18N_BASE_URL`.\n\n5. **Traduisez les pages, si vous le voulez.** Un dossier par langue à\n   l’intérieur de la source ; la locale par défaut reste où elle est et ne\n   déplace aucune URL :\n\n   ```ts [app\u002Fapp.config.ts]\n   sources: [{ path: 'docs', locales: ['en-GB', 'fr'] }]\n   ```\n\n   ::file-tree{title=\"docs\u002F\"}\n   ---\n   tree:\n     - name: index.md\n     - name: 1.getting-started\u002F\n       children:\n         - name: index.md\n     - name: fr\u002F\n       children:\n         - name: index.md\n   ---\n   ::\n\n   Traduisez aussi peu de pages que vous voulez — tout le reste retombe sur\n   l’original, avec un bandeau qui en explique la raison au lecteur.\n\n6. **Ouvrez une page dans chaque locale** et vérifiez que l’interface a changé\n   de langue, que le chemin se résout toujours et qu’aucun libellé configuré ne\n   s’affiche en clé brute.\n::\n\n## Seulement certaines versions, ou un autre dépôt\n\n`locales` sur une ref l’emporte sur celui de la source, ce qui est la forme\nhabituelle : la version courante est traduite et les deux précédentes non.\n\n```ts\n{\n  path: 'docs',\n  locales: ['en-GB', 'fr'],\n  refs: [\n    { tag: 'v2.0.0' },                     \u002F\u002F les deux langues\n    { tag: 'v1.0.0', locales: ['en-GB'] }  \u002F\u002F l’original seulement\n  ]\n}\n```\n\nLa forme objet déplace une langue entièrement ailleurs — son propre dépôt, avec\nses propres mainteneurs et son propre rythme :\n\n```ts\nlocales: ['en-GB', { locale: 'fr', repo: 'acme\u002Fdocs-fr', path: 'docs' }]\n```\n\nC’est ce que font React et Vue en dehors de leur outillage, avec `de.react.dev`\net l’organisation `vuejs-translations`, parce que les traducteurs travaillent\nselon leur propre calendrier et leur propre relecture. Ici, c’est une entrée de\nsource plutôt qu’un second site — un index de recherche, un sélecteur de langue.\n\n::callout{type=\"warning\" title=\"Ce que coûte une traduction à la compilation\"}\nEnviron **deux secondes de compilation et 0,6 Mo de base de données par langue ×\nversion × dépôt**, mesuré linéaire jusqu’à au moins 200 collections. Traduire\nchaque version de chaque dépôt multiplie les trois ; ne traduire que la version\ncourante est ce que font la plupart des projets.\n::\n\n## Quand une page n’a pas de traduction\n\nLe lecteur reçoit la langue la plus proche qui l’a, avec un bandeau, et la page\nporte `noindex` ainsi qu’un canonical pointant vers la langue dans laquelle elle\nest réellement. La chaîne — locale, langue de base, région sœur,\n`fallbackLocale`, original — est dans [Localisation](\u002Fconcepts\u002Flocalisation).\n\n## Liste de contrôle\n\n- [ ] `duxt.locales` liste exactement les locales que vous servez\n- [ ] `\u002Fsitemap.xml` contient une entrée par page et par locale, et aucune autre\n- [ ] Les liens `hreflang` sont absolus\n- [ ] Aucun libellé configuré ne s’affiche en clé brute\n- [ ] Changer de locale garde le lecteur sur la même page\n- [ ] Une page non traduite affiche le bandeau de repli, pas un 404\n- [ ] `duxt.sourceOptions.defaultLocale` correspond à `i18n.defaultLocale`\n",{"title":115,"description":118},{"loc":116},"HXGEDWzmdDLBmtYX_xKoDk2R5o049-SxXotxqEwRHEw","fr","fr-FR",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1389},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1391},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M9 18.12L10 14H4.17a2 2 0 0 1-1.92-2.56l2.33-8A2 2 0 0 1 6.5 2H20a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2h-2.76a2 2 0 0 0-1.79 1.11L12 22a3.13 3.13 0 0 1-3-3.88M17 14V2\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1393},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.12 2.12 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.12 2.12 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.12 2.12 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.12 2.12 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.12 2.12 0 0 0 1.597-1.16z\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1395},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 8v4m0 4h.01\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1397},"\u003Cpath fill=\"currentColor\" d=\"M20.317 4.37a19.8 19.8 0 0 0-4.885-1.515a.074.074 0 0 0-.079.037c-.21.375-.444.864-.608 1.25a18.3 18.3 0 0 0-5.487 0a13 13 0 0 0-.617-1.25a.08.08 0 0 0-.079-.037A19.7 19.7 0 0 0 3.677 4.37a.1.1 0 0 0-.032.027C.533 9.046-.32 13.58.099 18.057a.08.08 0 0 0 .031.057a19.9 19.9 0 0 0 5.993 3.03a.08.08 0 0 0 .084-.028a14 14 0 0 0 1.226-1.994a.076.076 0 0 0-.041-.106a13 13 0 0 1-1.872-.892a.077.077 0 0 1-.008-.128a10 10 0 0 0 .372-.292a.07.07 0 0 1 .077-.01c3.928 1.793 8.18 1.793 12.062 0a.07.07 0 0 1 .078.01q.181.149.373.292a.077.077 0 0 1-.006.127a12.3 12.3 0 0 1-1.873.892a.077.077 0 0 0-.041.107c.36.698.772 1.362 1.225 1.993a.08.08 0 0 0 .084.028a19.8 19.8 0 0 0 6.002-3.03a.08.08 0 0 0 .032-.054c.5-5.177-.838-9.674-3.549-13.66a.06.06 0 0 0-.031-.03M8.02 15.33c-1.182 0-2.157-1.085-2.157-2.419c0-1.333.956-2.419 2.157-2.419c1.21 0 2.176 1.096 2.157 2.42c0 1.333-.956 2.418-2.157 2.418m7.975 0c-1.183 0-2.157-1.085-2.157-2.419c0-1.333.955-2.419 2.157-2.419c1.21 0 2.176 1.096 2.157 2.42c0 1.333-.946 2.418-2.157 2.418\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1399},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v16m4-8h2m-2-4h2m2.001 10A2 2 0 0 0 22 17V5a2 2 0 0 0-1.999-2L16 3.002A5 5 0 0 0 12 5a5 5 0 0 0-4-2H4a2 2 0 0 0-2 2v12a2 2 0 0 0 1.999 2H8a5 5 0 0 1 4 2a5 5 0 0 1 4-2zM6 13h2M6 9h2\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1401},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1403},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497zM15 5l4 4\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1405},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 10a1 1 0 0 0 1-1V6a1 1 0 0 0-1-1h-2.5a1 1 0 0 1-.8-.4l-.9-1.2A1 1 0 0 0 15 3h-2a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1Zm0 11a1 1 0 0 0 1-1v-3a1 1 0 0 0-1-1h-2.9a1 1 0 0 1-.88-.55l-.42-.85a1 1 0 0 0-.92-.6H13a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1ZM3 5a2 2 0 0 0 2 2h3\"\u002F>\u003Cpath d=\"M3 3v13a2 2 0 0 0 2 2h3\"\u002F>\u003C\u002Fg>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1407},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m9 18l6-6l-6-6\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1409},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 14l1.5-2.9A2 2 0 0 1 9.24 10H20a2 2 0 0 1 1.94 2.5l-1.54 6a2 2 0 0 1-1.95 1.5H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H18a2 2 0 0 1 2 2v2\"\u002F>",{"left":834,"top":834,"width":1411,"height":1411,"rotate":834,"vFlip":836,"hFlip":836,"body":1412},32,"\u003Cpath fill=\"none\" stroke=\"#755838\" d=\"M2.5 7.955h27v16.091h-27z\"\u002F>\u003Cpath fill=\"#755838\" d=\"M5.909 20.636v-9.272h2.727l2.728 3.409l2.727-3.409h2.727v9.272h-2.727v-5.318l-2.727 3.409l-2.728-3.409v5.318zm17.046 0l-4.091-4.5h2.727v-4.772h2.727v4.772h2.727z\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1414},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m21.73 18l-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3M12 9v4m0 4h.01\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1416},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m12 19l-7-7l7-7m7 7H5\"\u002F>",{"left":834,"top":834,"width":835,"height":835,"rotate":834,"vFlip":836,"hFlip":836,"body":1418},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"\u002F>",1789004686430]