[{"data":1,"prerenderedAt":1616},["ShallowReactive",2],{"duxt-navigation-docs-docs":3,"i-lucide:rocket":832,"i-lucide:compass":837,"i-lucide:list":839,"i-lucide:ruler":841,"i-lucide:gavel":843,"i-lucide:book-open":845,"i-lucide:folder-git":847,"i-lucide:git-compare":849,"i-lucide:languages":851,"i-lucide:palette":853,"i-lucide:signpost":855,"i-lucide:cloud-upload":857,"i-lucide:thumbs-up":859,"i-lucide:badge-check":861,"i-lucide:menu":863,"i-lucide:chevron-down":865,"i-lucide:search":867,"i-simple-icons:github":869,"i-flag:us-4x3":871,"i-lucide:moon":875,"docs-en-US-\u002Fguides\u002Fcollect-page-feedback":877,"i-lucide:copy":1592,"i-lucide:thumbs-down":1594,"i-lucide:star":1596,"i-lucide:circle-alert":1598,"i-simple-icons:discord":1600,"i-lucide:book-open-text":1602,"i-lucide:arrow-up-right":1604,"i-lucide:pencil":1606,"duxt-code-vue-\u003Cscript setup lang=\"ts\">\nimport DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\nconst route = useRoute();\n\n\u002F\u002F The event carries the answer and nothing else — the page it belongs to is\n\u002F\u002F yours to read, and `fullPath` is the one that keeps the locale, repository\n\u002F\u002F and version prefixes the answer was actually given under.\nasync function onFeedback(helpful: boolean) {\n  await $fetch('\u002Fapi\u002Ffeedback', {\n    method: 'POST',\n    body: { path: route.fullPath, helpful }\n  });\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CDuxtPageFeedbackBase @feedback=\"onFeedback\" \u002F>\n\u003C\u002Ftemplate>\n":784,"duxt-code-ts-export default defineEventHandler(async (event) => {\n  const { path, helpful } = await readBody(event);\n\n  \u002F\u002F Your storage, your analytics, your queue.\n  await recordFeedback({ path, helpful });\n\n  return { ok: true };\n});\n":784,"duxt-code-vue-\u003Cscript setup lang=\"ts\">\nimport DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CDuxtPageFeedbackBase v-slot=\"{ answered, answer }\">\n    \u003Cform v-if=\"answered === undefined\" @submit.prevent=\"answer(true)\">\n      \u003Clabel>\n        Tell us what is missing\n        \u003Ctextarea name=\"comment\" \u002F>\n      \u003C\u002Flabel>\n      \u003Cbutton type=\"submit\">Send\u003C\u002Fbutton>\n    \u003C\u002Fform>\n    \u003Cp v-else>Thank you.\u003C\u002Fp>\n  \u003C\u002FDuxtPageFeedbackBase>\n\u003C\u002Ftemplate>\n":784,"i-lucide:triangle-alert":1608,"i-lucide:arrow-left":1610,"i-lucide:arrow-right":1612,"i-lucide:chevron-right":1614},[4,25,94,148,743,751,771,826],{"title":5,"path":6,"stem":7,"children":8},"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","What duxt is, and what arrives with a single line of config.",{"title":14,"path":15,"stem":16,"icon":17,"description":18},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F1.installation","lucide:download","Add the layer, extend it, write Markdown.",{"title":20,"path":21,"stem":22,"icon":23,"description":24},"Configuration","\u002Fgetting-started\u002Fconfiguration","1.getting-started\u002F2.configuration","lucide:settings","One file configures the whole site — what belongs in it, and how it merges.",{"title":26,"path":27,"stem":28,"children":29},"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","How the layer works — the sources model, the URL scheme, the collections and the checks.",{"title":35,"path":36,"stem":37,"icon":38,"description":39},"Layers and overriding","\u002Fconcepts\u002Flayers","2.concepts\u002F1.layers","lucide:layers","What a Nuxt layer gives you, what it takes away, and which paths do not resolve the way they read.",{"title":41,"path":42,"stem":43,"icon":44,"description":45},"Theming","\u002Fconcepts\u002Ftheming","2.concepts\u002F10.theming","lucide:palette","How the theme is put together — owned components, one token layer, and a dark mode that switches on a class.",{"title":47,"path":48,"stem":49,"icon":50,"description":51},"Sources","\u002Fconcepts\u002Fsources","2.concepts\u002F2.sources","lucide:git-branch","One list of sources becomes every collection, prefix and version the site serves.",{"title":53,"path":54,"stem":55,"icon":56,"description":57},"URLs and versions","\u002Fconcepts\u002Furls-and-versions","2.concepts\u002F3.urls-and-versions","lucide:git-compare","How the repository and version segments appear, and what a reader in an old version is told.",{"title":59,"path":60,"stem":61,"icon":62,"description":63},"Collections","\u002Fconcepts\u002Fcollections","2.concepts\u002F4.collections","lucide:database","What Content builds from the sources, and the four things the schema adds.",{"title":65,"path":66,"stem":67,"icon":68,"description":69},"Generated sections","\u002Fconcepts\u002Fgenerated-sections","2.concepts\u002F5.generated-sections","lucide:file-cog","An artefact plus a type, published as pages — what the registry is, and the two policies a type answers.",{"title":71,"path":72,"stem":73,"icon":74,"description":75},"What the build checks","\u002Fconcepts\u002Fbuild-checks","2.concepts\u002F6.build-checks","lucide:shield-check","The silent failures this layer had, turned into messages.",{"title":77,"path":78,"stem":79,"icon":80,"description":81},"Machine readers","\u002Fconcepts\u002Fmachine-readers","2.concepts\u002F7.machine-readers","lucide:bot","What a model gets — llms.txt, the raw Markdown of any page, and a real MCP server.",{"title":83,"path":84,"stem":85,"icon":86,"description":87},"SEO","\u002Fconcepts\u002Fseo","2.concepts\u002F8.seo","lucide:search","What every page emits for crawlers and social cards, which module writes it, and the one value the layer cannot guess.",{"title":89,"path":90,"stem":91,"icon":92,"description":93},"Localisation","\u002Fconcepts\u002Flocalisation","2.concepts\u002F9.localisation","lucide:languages","Seven locales ship with the layer, and every configured string takes three forms.",{"title":95,"path":96,"stem":97,"children":98},"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","One task per page, start to finish — several repositories, several versions, several languages, and a deploy.",{"title":104,"path":105,"stem":106,"icon":107,"description":108},"Several repositories","\u002Fguides\u002Fseveral-repositories","3.guides\u002F1.several-repositories","lucide:folder-git","Serve the documentation of several projects from one site.",{"title":110,"path":111,"stem":112,"icon":56,"description":113},"Several versions","\u002Fguides\u002Fseveral-versions","3.guides\u002F2.several-versions","Serve the same documentation at several refs, with a switcher and a banner.",{"title":115,"path":116,"stem":117,"icon":92,"description":118},"Several languages","\u002Fguides\u002Fseveral-languages","3.guides\u002F3.several-languages","Serve the interface in several languages, and translate the pages themselves.",{"title":120,"path":121,"stem":122,"icon":44,"description":123},"Override the theme","\u002Fguides\u002Foverride-the-theme","3.guides\u002F4.override-the-theme","Change a colour, replace a component, add a shadcn-vue primitive.",{"title":125,"path":126,"stem":127,"icon":128,"description":129},"Move a page","\u002Fguides\u002Fmove-a-page","3.guides\u002F5.move-a-page","lucide:signpost","redirectFrom in the frontmatter, turned into route rules under every prefix.",{"title":131,"path":132,"stem":133,"icon":134,"description":135},"Deploy a site","\u002Fguides\u002Fdeploy-a-site","3.guides\u002F6.deploy-a-site","lucide:cloud-upload","Where a duxt site can run, what it needs there, and why content is not refreshed at runtime.",{"title":137,"path":138,"stem":139,"icon":140,"description":141},"Collect page feedback","\u002Fguides\u002Fcollect-page-feedback","3.guides\u002F7.collect-page-feedback","lucide:thumbs-up","Wrap DuxtPageFeedback, keep the answer where your analytics already live.",{"title":143,"path":144,"stem":145,"icon":146,"description":147},"Brand your site","\u002Fguides\u002Fbrand-your-site","3.guides\u002F8.brand-your-site","lucide:badge-check","Set the name, the wordmark and the icons, so the site reads as yours rather than as the layer's.",{"title":149,"path":150,"stem":151,"children":152},"Reference","\u002Freference","4.reference",[153,157,161,193,197,203,343,490,611,656,716],{"title":149,"path":150,"stem":154,"icon":155,"description":156},"4.reference\u002Findex","lucide:list","The layer's public surface — config keys, frontmatter, components, composables and endpoints.",{"title":20,"path":158,"stem":159,"icon":23,"description":160},"\u002Freference\u002Fconfiguration","4.reference\u002F1.configuration","Every key under duxt in app.config.ts — what it controls, and when it is read.",{"title":162,"path":163,"stem":164,"children":165,"icon":167,"description":168},"Changelog","\u002Freference\u002Fchangelog","4.reference\u002F10.changelog\u002Findex",[166,169,175,181,187],{"title":162,"path":163,"stem":164,"icon":167,"description":168},"lucide:tag","A release log, published as pages — a timeline, a page per release, and a feed.",{"title":170,"path":171,"stem":172,"icon":173,"description":174},"Declaring the section","\u002Freference\u002Fchangelog\u002Fsection","4.reference\u002F10.changelog\u002F1.section","lucide:file-clock","The `changelog` section type — where the file lives, and the two policies it answers.",{"title":176,"path":177,"stem":178,"icon":179,"description":180},"Granularity","\u002Freference\u002Fchangelog\u002Fgranularity","4.reference\u002F10.changelog\u002F2.granularity","lucide:split","A page per release, or the file as the one page it was written as.",{"title":182,"path":183,"stem":184,"icon":185,"description":186},"What is read","\u002Freference\u002Fchangelog\u002Fwhat-is-read","4.reference\u002F10.changelog\u002F3.what-is-read","lucide:scan-text","Which headings become releases, which become groups, and what happens to the rest.",{"title":188,"path":189,"stem":190,"icon":191,"description":192},"Layout and components","\u002Freference\u002Fchangelog\u002Fcomponents","4.reference\u002F10.changelog\u002F4.components","lucide:box","The layout a split history renders in, and the two MDC components its pages are made of.",{"title":47,"path":194,"stem":195,"icon":50,"description":196},"\u002Freference\u002Fsources","4.reference\u002F2.sources","The fields of a source entry, its refs, and the options that shape the URLs.",{"title":198,"path":199,"stem":200,"icon":201,"description":202},"Frontmatter","\u002Freference\u002Ffrontmatter","4.reference\u002F3.frontmatter","lucide:file-code","The fields a page may carry beyond title and description, and the two the build fills in.",{"title":204,"path":205,"stem":206,"children":207,"icon":209,"description":210},"MDC components","\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","The blocks a Markdown page can call, one page each, with their 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","An aside the reader is meant to stop at — a tip, a warning, a danger.",{"title":218,"path":219,"stem":220,"icon":221,"description":222},"Package managers","\u002Freference\u002Fmdc-components\u002Fpackage-managers","4.reference\u002F4.mdc-components\u002F10.package-managers","lucide:package","One command, one tab per package manager, remembered across pages.",{"title":224,"path":225,"stem":226,"icon":227,"description":228},"File tree","\u002Freference\u002Fmdc-components\u002Ffile-tree","4.reference\u002F4.mdc-components\u002F11.file-tree","lucide:folder-tree","A folder structure, with icons per file type.",{"title":230,"path":231,"stem":232,"icon":233,"description":234},"Preview","\u002Freference\u002Fmdc-components\u002Fpreview","4.reference\u002F4.mdc-components\u002F12.preview","lucide:eye","A component rendered as the page renders it, with its source beside it.",{"title":236,"path":237,"stem":238,"icon":239,"description":240},"Page cards","\u002Freference\u002Fmdc-components\u002Fpage-cards","4.reference\u002F4.mdc-components\u002F13.page-cards","lucide:layout-grid","A section's children, as cards.",{"title":242,"path":243,"stem":244,"icon":245,"description":246},"Partial","\u002Freference\u002Fmdc-components\u002Fpartial","4.reference\u002F4.mdc-components\u002F14.partial","lucide:puzzle","A block written once and rendered in every source that needs it.",{"title":248,"path":249,"stem":250,"icon":251,"description":252},"Since","\u002Freference\u002Fmdc-components\u002Fsince","4.reference\u002F4.mdc-components\u002F15.since","lucide:milestone","The version something arrived in, beside a heading.",{"title":254,"path":255,"stem":256,"icon":257,"description":258},"Mermaid","\u002Freference\u002Fmdc-components\u002Fmermaid","4.reference\u002F4.mdc-components\u002F16.mermaid","lucide:workflow","A diagram from a fence or a prop.",{"title":260,"path":261,"stem":262,"children":263,"icon":265,"description":266},"Prose overrides","\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","What the layer changes about plain Markdown — links, headings, images, code and tables.",{"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","A link, resolved against the source it was written in.",{"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","Headings, each with a permalink anchor.",{"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","An image: theme-aware, and 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","The code block: filename, language icon, copy button.",{"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","A table that scrolls instead of the page.",{"title":298,"path":299,"stem":300,"icon":301,"description":302},"Steps","\u002Freference\u002Fmdc-components\u002Fsteps","4.reference\u002F4.mdc-components\u002F2.steps","lucide:list-ordered","An ordered list drawn as numbered steps on a rail.",{"title":304,"path":305,"stem":306,"icon":201,"description":307},"Code group","\u002Freference\u002Fmdc-components\u002Fcode-group","4.reference\u002F4.mdc-components\u002F3.code-group","Several fences as one tabbed block, labelled by filename.",{"title":309,"path":310,"stem":311,"icon":312,"description":313},"Tab group","\u002Freference\u002Fmdc-components\u002Ftab-group","4.reference\u002F4.mdc-components\u002F4.tab-group","lucide:panels-top-left","Tabs for anything that is not 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","One panel of a tab group.",{"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","Collapsible sections — a FAQ, or answers a reader picks from.",{"title":327,"path":328,"stem":329,"icon":330,"description":331},"Accordion item","\u002Freference\u002Fmdc-components\u002Faccordion-item","4.reference\u002F4.mdc-components\u002F7.accordion-item","lucide:chevron-down","One collapsible section.",{"title":333,"path":334,"stem":335,"icon":336,"description":337},"Field group","\u002Freference\u002Fmdc-components\u002Ffield-group","4.reference\u002F4.mdc-components\u002F8.field-group","lucide:list-tree","A list of fields as one block.",{"title":339,"path":340,"stem":341,"icon":167,"description":342},"Field","\u002Freference\u002Fmdc-components\u002Ffield","4.reference\u002F4.mdc-components\u002F9.field","One parameter, property or option, with its type and default.",{"title":344,"path":345,"stem":346,"children":347,"icon":349,"description":350},"Components","\u002Freference\u002Fcomponents","4.reference\u002F5.components\u002Findex",[348,351,371,412,459],{"title":344,"path":345,"stem":346,"icon":349,"description":350},"lucide:component","The layer's own components, one page each — what each is for, and what it takes.",{"title":352,"path":353,"stem":354,"children":355,"icon":357,"description":358},"Layout","\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","The two components that frame a page — the navbar and the footer.",{"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","The navbar: title, navigation, search, and the icon links.",{"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","The footer: the site's name, its legal links, and the layer's own line.",{"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},"Getting around — the section row, the sidebar, the trail, the contents and prev\u002Fnext.",{"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","The second navbar row — the top-level parts of the 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","The sidebar tree.",{"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","One entry of the sidebar.",{"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","The trail above the page title.",{"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","The table of contents, and the aside under it.",{"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","Previous and next, bounded by the section.",{"title":413,"path":414,"stem":415,"children":416,"icon":418,"description":419},"Controls","\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","What a reader operates — search, the switchers, the shortcut sheet, and two indicators.",{"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","Search across every source, ranked together.",{"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","The version badge, and the switcher when there is more than one.",{"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","The bar telling a reader this version is not the current one.",{"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","The language switcher.",{"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","How far down the page the reader is.",{"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","The keyboard shortcut sheet, on ?.",{"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","The first focusable element on the 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","The components that belong to the page itself.",{"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","Where the page came from: edit link, last updated, contributors.",{"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","Hand this page to a model, or read its 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","Was this page helpful?",{"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","The card around a code block.",{"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","The functions the layer exposes to your own components, one page each.",{"title":499,"path":500,"stem":501,"children":502,"icon":62,"description":504},"Config and content","\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},"The merged config, and which collection serves the page being read.",{"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","The merged config, every text field already resolved.",{"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","Which collection serves this 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","The navigation tree for the collection serving this 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","The part of the documentation this page is in.",{"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","The trail from the section down to a page.",{"title":533,"path":534,"stem":535,"children":536,"icon":538,"description":539},"Paths and 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","Reading a URL, writing one back out, and knowing which version is being read.",{"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","The path the documentation is at, locale stripped.",{"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","A documentation path, written back out as a link.",{"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","What the switcher shows, what the banner says, whether to index.",{"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","The configured origin, and paths made absolute.",{"title":562,"path":563,"stem":564,"children":565,"icon":101,"description":567},"Reading experience","\u002Freference\u002Fcomposables\u002Freading","4.reference\u002F6.composables\u002F3.reading\u002Findex",[566,568,572,578,583,589,595,600,606],{"title":562,"path":563,"stem":564,"icon":101,"description":567},"Search, headings, focus, history, and the choices a reader makes.",{"title":569,"path":570,"stem":571,"icon":86,"description":424},"useDuxtSearch()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-search","4.reference\u002F6.composables\u002F3.reading\u002F1.use-duxt-search",{"title":573,"path":574,"stem":575,"icon":576,"description":577},"useFuzzySearch()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-fuzzy-search","4.reference\u002F6.composables\u002F3.reading\u002F2.use-fuzzy-search","lucide:spell-check","Typo tolerance beside the exact index.",{"title":579,"path":580,"stem":581,"icon":277,"description":582},"useActiveHeading()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-active-heading","4.reference\u002F6.composables\u002F3.reading\u002F3.use-active-heading","The heading currently in view.",{"title":584,"path":585,"stem":586,"icon":587,"description":588},"useDuxtPageFocus()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-page-focus","4.reference\u002F6.composables\u002F3.reading\u002F4.use-duxt-page-focus","lucide:focus","Moves focus to the heading after a client-side navigation.",{"title":590,"path":591,"stem":592,"icon":593,"description":594},"useRecentPages()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-recent-pages","4.reference\u002F6.composables\u002F3.reading\u002F5.use-recent-pages","lucide:history","The last five pages this reader opened.",{"title":596,"path":597,"stem":598,"icon":221,"description":599},"usePackageManager()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-package-manager","4.reference\u002F6.composables\u002F3.reading\u002F6.use-package-manager","The package manager a reader picked.",{"title":601,"path":602,"stem":603,"icon":604,"description":605},"useDuxtToast()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-toast","4.reference\u002F6.composables\u002F3.reading\u002F7.use-duxt-toast","lucide:bell","Notifications, wrapped so no component imports the library.",{"title":607,"path":608,"stem":609,"icon":451,"description":610},"useDuxtShortcuts()","\u002Freference\u002Fcomposables\u002Freading\u002Fuse-duxt-shortcuts","4.reference\u002F6.composables\u002F3.reading\u002F8.use-duxt-shortcuts","The keys the theme listens to.",{"title":612,"path":613,"stem":614,"children":615,"icon":538,"description":617},"Endpoints","\u002Freference\u002Fendpoints","4.reference\u002F7.endpoints\u002Findex",[616,618,623,629,634,639,644,650],{"title":612,"path":613,"stem":614,"icon":538,"description":617},"Everything the site serves besides pages, one page each.",{"title":619,"path":620,"stem":621,"icon":465,"description":622},"\u002Fllms.txt","\u002Freference\u002Fendpoints\u002Fllms-txt","4.reference\u002F7.endpoints\u002F1.llms-txt","The documentation as a Markdown index, per llmstxt.org.",{"title":624,"path":625,"stem":626,"icon":627,"description":628},"\u002Fllms-full.txt","\u002Freference\u002Fendpoints\u002Fllms-full-txt","4.reference\u002F7.endpoints\u002F2.llms-full-txt","lucide:file-stack","The same pages, whole, in one Markdown file.",{"title":630,"path":631,"stem":632,"icon":201,"description":633},"\u003Cpage>.md","\u002Freference\u002Fendpoints\u002Fpage-markdown","4.reference\u002F7.endpoints\u002F3.page-markdown","Any page source, at its own URL plus .md.",{"title":635,"path":636,"stem":637,"icon":80,"description":638},"\u002Fmcp","\u002Freference\u002Fendpoints\u002Fmcp","4.reference\u002F7.endpoints\u002F4.mcp","An MCP server over the same content.",{"title":640,"path":641,"stem":642,"icon":86,"description":643},"\u002Fsitemap.xml and \u002Frobots.txt","\u002Freference\u002Fendpoints\u002Fsitemap-and-robots","4.reference\u002F7.endpoints\u002F5.sitemap-and-robots","What a crawler is pointed at, and what it is kept out of.",{"title":645,"path":646,"stem":647,"icon":648,"description":649},"\u002Frss.xml","\u002Freference\u002Fendpoints\u002Frss-xml","4.reference\u002F7.endpoints\u002F6.rss-xml","lucide:rss","The feed, once a section is named.",{"title":651,"path":652,"stem":653,"icon":654,"description":655},"\u002F_duxt\u002Fdevtools","\u002Freference\u002Fendpoints\u002Fdevtools","4.reference\u002F7.endpoints\u002F7.devtools","lucide:wrench","The route the Nuxt Devtools panel is served from. Dev only.",{"title":657,"path":658,"stem":659,"children":660,"icon":654,"description":662},"Devtools","\u002Freference\u002Fdevtools","4.reference\u002F8.devtools\u002Findex",[661,663,667,672,677,683,689,695,700,705,710],{"title":657,"path":658,"stem":659,"icon":654,"description":662},"Ten panels that show what your sources became. Dev only.",{"title":47,"path":664,"stem":665,"icon":514,"description":666},"\u002Freference\u002Fdevtools\u002Fsources","4.reference\u002F8.devtools\u002F1.sources","What `duxt.sources` became — one collection per source, version and language.",{"title":668,"path":669,"stem":670,"icon":128,"description":671},"Redirects","\u002Freference\u002Fdevtools\u002Fredirects","4.reference\u002F8.devtools\u002F10.redirects","Every redirect the server ships, and which of them the layer wrote.",{"title":673,"path":674,"stem":675,"icon":538,"description":676},"Paths","\u002Freference\u002Fdevtools\u002Fpaths","4.reference\u002F8.devtools\u002F2.paths","Paste a URL, see which source claims it and what it finds there.",{"title":678,"path":679,"stem":680,"icon":681,"description":682},"Pages","\u002Freference\u002Fdevtools\u002Fpages","4.reference\u002F8.devtools\u002F3.pages","lucide:files","Every page of every collection, with its frontmatter and git metadata.",{"title":684,"path":685,"stem":686,"icon":687,"description":688},"Versions","\u002Freference\u002Fdevtools\u002Fversions","4.reference\u002F8.devtools\u002F4.versions","lucide:columns-3","Which version — and which language — carries which page.",{"title":690,"path":691,"stem":692,"icon":693,"description":694},"Checks","\u002Freference\u002Fdevtools\u002Fchecks","4.reference\u002F8.devtools\u002F5.checks","lucide:check-check","The build validator, run against what the site is serving now.",{"title":696,"path":697,"stem":698,"icon":86,"description":699},"Search","\u002Freference\u002Fdevtools\u002Fsearch","4.reference\u002F8.devtools\u002F6.search","What the search index holds, through the same query the dialog runs.",{"title":701,"path":702,"stem":703,"icon":418,"description":704},"Config","\u002Freference\u002Fdevtools\u002Fconfig","4.reference\u002F8.devtools\u002F7.config","The merged `duxt` config, and which side of the merge each value came from.",{"title":706,"path":707,"stem":708,"icon":92,"description":709},"i18n","\u002Freference\u002Fdevtools\u002Fi18n","4.reference\u002F8.devtools\u002F8.i18n","Message keys per locale, against the base language.",{"title":711,"path":712,"stem":713,"icon":714,"description":715},"Cache","\u002Freference\u002Fdevtools\u002Fcache","4.reference\u002F8.devtools\u002F9.cache","lucide:hard-drive","Content's download cache, and a way to drop one entry.",{"title":717,"path":718,"stem":719,"children":720,"icon":722,"description":723},"API reference","\u002Freference\u002Fopenapi","4.reference\u002F9.openapi\u002Findex",[721,724,728,732,738],{"title":717,"path":718,"stem":719,"icon":722,"description":723},"lucide:plug","An OpenAPI document, published as reference pages with a client that sends real requests.",{"title":170,"path":725,"stem":726,"icon":201,"description":727},"\u002Freference\u002Fopenapi\u002Fsection","4.reference\u002F9.openapi\u002F1.section","The `openapi` section type — where the document lives, and what it becomes.",{"title":344,"path":729,"stem":730,"icon":191,"description":731},"\u002Freference\u002Fopenapi\u002Fcomponents","4.reference\u002F9.openapi\u002F2.components","The three MDC components a generated reference page is made of.",{"title":733,"path":734,"stem":735,"icon":736,"description":737},"The try-it client","\u002Freference\u002Fopenapi\u002Ftry-it","4.reference\u002F9.openapi\u002F3.try-it","lucide:send","A real request, sent by the reader's own browser.",{"title":739,"path":740,"stem":741,"icon":488,"description":742},"Request samples","\u002Freference\u002Fopenapi\u002Frequest-samples","4.reference\u002F9.openapi\u002F4.request-samples","The same request in twelve clients, and how to add your own.",{"title":744,"path":745,"stem":746,"children":747,"icon":749,"description":750},"Credits","\u002Fcredits","5.credits\u002Findex",[748],{"title":744,"path":745,"stem":746,"icon":749,"description":750},"lucide:heart","What duxt is built on, and what it was built after.",{"title":752,"path":753,"stem":754,"children":755},"Conventions","\u002Fconventions","6.conventions",[756,760,766],{"title":752,"path":753,"stem":757,"icon":758,"description":759},"6.conventions\u002Findex","lucide:ruler","Project-specific rules — the ones a reader could not infer from the code.",{"title":761,"path":762,"stem":763,"icon":764,"description":765},"Branding","\u002Fconventions\u002Fbranding","6.conventions\u002F1.branding","lucide:shapes","The [d]uxt mark — where each asset is used, why the icon's brackets are redrawn, and the colours that are fixed.",{"title":767,"path":768,"stem":769,"icon":283,"description":770},"Icons","\u002Fconventions\u002Ficons","6.conventions\u002F2.icons","Four icon sets, and the one question that decides which of them draws a given mark.",{"title":772,"path":773,"stem":774,"children":775},"Architecture decisions","\u002Fadr","99.adr",[776,780,786,791,796,801,806,811,816,821],{"title":772,"path":773,"stem":777,"icon":778,"description":779},"99.adr\u002Findex","lucide:gavel","The decision log — every architecture decision recorded for duxt.",{"title":781,"path":782,"stem":783,"icon":784,"description":785},"Build duxt as a layer carrying a module","\u002Fadr\u002F0001-build-duxt-as-a-layer-carrying-a-module","99.adr\u002F0001-build-duxt-as-a-layer-carrying-a-module",null,"Distribute the theme as a Nuxt layer whose root is the package, rather than as a starter template.",{"title":787,"path":788,"stem":789,"icon":784,"description":790},"Generate the collections from one source list","\u002Fadr\u002F0002-generate-the-collections-from-one-source-list","99.adr\u002F0002-generate-the-collections-from-one-source-list","Compute Content collections from a compact sources list at config load time instead of having consumers declare them.",{"title":792,"path":793,"stem":794,"icon":784,"description":795},"Decide the URL prefixes at build time","\u002Fadr\u002F0003-decide-the-url-prefixes-at-build-time","99.adr\u002F0003-decide-the-url-prefixes-at-build-time","Whether a repository or version segment appears is settled by the source list before the first request, never per request.",{"title":797,"path":798,"stem":799,"icon":784,"description":800},"Render Markdown components with MDC","\u002Fadr\u002F0004-render-markdown-components-with-mdc","99.adr\u002F0004-render-markdown-components-with-mdc","Use Content's own MDC syntax for components inside Markdown rather than adopting MDX.",{"title":802,"path":803,"stem":804,"icon":784,"description":805},"Ship the layer without owner-specific links","\u002Fadr\u002F0005-ship-the-layer-without-owner-specific-links","99.adr\u002F0005-ship-the-layer-without-owner-specific-links","Every default that would name a specific project — repository, issue tracker, community, imprint — ships empty.",{"title":807,"path":808,"stem":809,"icon":784,"description":810},"Rebuild on a schedule rather than refresh at runtime","\u002Fadr\u002F0006-rebuild-on-a-schedule-rather-than-refresh-at-runtime","99.adr\u002F0006-rebuild-on-a-schedule-rather-than-refresh-at-runtime","A site reading another repository picks up its changes when it builds, and no runtime refresh is offered.",{"title":812,"path":813,"stem":814,"icon":784,"description":815},"Serve translations as collections of their own","\u002Fadr\u002F0007-serve-translations-as-collections-of-their-own","99.adr\u002F0007-serve-translations-as-collections-of-their-own","Add a locale dimension to a source rather than a locale segment to the content path.",{"title":817,"path":818,"stem":819,"icon":784,"description":820},"Build the theme on owned shadcn-vue components","\u002Fadr\u002F0008-build-the-theme-on-owned-shadcn-vue-components","99.adr\u002F0008-build-the-theme-on-owned-shadcn-vue-components","The layer holds the source of its interface components rather than importing them from a component library or a ready-made documentation theme.",{"title":822,"path":823,"stem":824,"icon":784,"description":825},"Take the SEO stack from the Nuxt SEO bundle","\u002Fadr\u002F0009-take-the-seo-stack-from-the-nuxt-seo-bundle","99.adr\u002F0009-take-the-seo-stack-from-the-nuxt-seo-bundle","The layer installs @nuxtjs\u002Fseo and hands it the head tags and structured data it used to write by hand, keeping only the rules that depend on versions and translations.",{"title":827,"path":828,"stem":829,"icon":830,"description":831},"Documentation","\u002F","index","lucide:book-open-text","A Nuxt layer that turns a repository's docs folder into a versioned, multi-repo documentation site.",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":836},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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":838},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":840},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":842},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":844},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":846},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":848},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":850},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":852},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":854},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":856},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":858},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":860},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":862},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":864},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":866},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":868},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":870},"\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":833,"top":833,"width":872,"height":873,"rotate":833,"vFlip":835,"hFlip":835,"body":874},640,480,"\u003Cpath fill=\"#bd3d44\" d=\"M0 0h640v480H0\"\u002F>\u003Cpath stroke=\"#fff\" stroke-width=\"37\" d=\"M0 55.3h640M0 129h640M0 203h640M0 277h640M0 351h640M0 425h640\"\u002F>\u003Cpath fill=\"#192f5d\" d=\"M0 0h364.8v258.5H0\"\u002F>\u003Cmarker id=\"SVGEq3dreKJ\" markerHeight=\"30\" markerWidth=\"30\">\u003Cpath fill=\"#fff\" d=\"m14 0l9 27L0 10h28L5 27z\"\u002F>\u003C\u002Fmarker>\u003Cpath fill=\"none\" marker-mid=\"url(#SVGEq3dreKJ)\" d=\"m0 0l16 11h61h61h61h61h60L47 37h61h61h60h61L16 63h61h61h61h61h60L47 89h61h61h60h61L16 115h61h61h61h61h60L47 141h61h61h60h61L16 166h61h61h61h61h60L47 192h61h61h60h61L16 218h61h61h61h61h60z\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":876},"\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":878,"from":1590,"asked":1591},{"id":879,"title":137,"body":880,"compare":784,"contributors":1580,"date":784,"description":141,"extension":1583,"icon":140,"lastUpdated":1584,"layout":784,"meta":1585,"navigation":835,"path":138,"rawbody":1586,"redirectFrom":784,"seo":1587,"sitemap":1588,"stem":139,"__hash__":1589},"docs\u002F3.guides\u002F7.collect-page-feedback.md",{"type":881,"value":882,"toc":1574},"minimark",[883,887,891,1288,1292,1295,1504,1514,1522,1526,1534,1538,1570],[884,885,886],"p",{},"Every documentation page ends with \"Was this page helpful?\", and the layer does\nnothing with the answer: it holds it in the component's own state for the length\nof the visit, emits an event, and stores nothing. Wrapping the component is how\nthe answer reaches you.",[888,889,298],"h2",{"id":890},"steps",[890,892,893],{},[894,895,896,1158,1282],"ol",{},[897,898,899,903,904,908,909,912,913],"li",{},[900,901,902],"strong",{},"Wrap the layer's component under its own name."," Nuxt resolves your file\nfirst, so ",[905,906,907],"code",{},"app\u002Fcomponents\u002FDuxtPageFeedback.vue"," in your project replaces the\nlayer's — and the ",[905,910,911],{},"@duxt"," alias still reaches the original by path, so the\nwrapper keeps the layer's markup, translations and reset-on-navigation:",[914,915,920],"pre",{"className":916,"code":917,"filename":907,"language":918,"meta":919,"style":919},"language-vue shiki shiki-themes github-light github-dark","\u003Cscript setup lang=\"ts\">\nimport DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\nconst route = useRoute();\n\n\u002F\u002F The event carries the answer and nothing else — the page it belongs to is\n\u002F\u002F yours to read, and `fullPath` is the one that keeps the locale, repository\n\u002F\u002F and version prefixes the answer was actually given under.\nasync function onFeedback(helpful: boolean) {\n  await $fetch('\u002Fapi\u002Ffeedback', {\n    method: 'POST',\n    body: { path: route.fullPath, helpful }\n  });\n}\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CDuxtPageFeedbackBase @feedback=\"onFeedback\" \u002F>\n\u003C\u002Ftemplate>\n","vue","",[905,921,922,952,971,978,997,1002,1009,1015,1021,1049,1066,1078,1084,1090,1096,1106,1111,1121,1149],{"__ignoreMap":919},[923,924,927,931,935,939,942,945,949],"span",{"class":925,"line":926},"line",1,[923,928,930],{"class":929},"sVt8B","\u003C",[923,932,934],{"class":933},"s9eBZ","script",[923,936,938],{"class":937},"sScJk"," setup",[923,940,941],{"class":937}," lang",[923,943,944],{"class":929},"=",[923,946,948],{"class":947},"sZZnC","\"ts\"",[923,950,951],{"class":929},">\n",[923,953,955,959,962,965,968],{"class":925,"line":954},2,[923,956,958],{"class":957},"szBVR","import",[923,960,961],{"class":929}," DuxtPageFeedbackBase ",[923,963,964],{"class":957},"from",[923,966,967],{"class":947}," '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue'",[923,969,970],{"class":929},";\n",[923,972,974],{"class":925,"line":973},3,[923,975,977],{"emptyLinePlaceholder":976},true,"\n",[923,979,981,984,988,991,994],{"class":925,"line":980},4,[923,982,983],{"class":957},"const",[923,985,987],{"class":986},"sj4cs"," route",[923,989,990],{"class":957}," =",[923,992,993],{"class":937}," useRoute",[923,995,996],{"class":929},"();\n",[923,998,1000],{"class":925,"line":999},5,[923,1001,977],{"emptyLinePlaceholder":976},[923,1003,1005],{"class":925,"line":1004},6,[923,1006,1008],{"class":1007},"sJ8bj","\u002F\u002F The event carries the answer and nothing else — the page it belongs to is\n",[923,1010,1012],{"class":925,"line":1011},7,[923,1013,1014],{"class":1007},"\u002F\u002F yours to read, and `fullPath` is the one that keeps the locale, repository\n",[923,1016,1018],{"class":925,"line":1017},8,[923,1019,1020],{"class":1007},"\u002F\u002F and version prefixes the answer was actually given under.\n",[923,1022,1024,1027,1030,1033,1036,1040,1043,1046],{"class":925,"line":1023},9,[923,1025,1026],{"class":957},"async",[923,1028,1029],{"class":957}," function",[923,1031,1032],{"class":937}," onFeedback",[923,1034,1035],{"class":929},"(",[923,1037,1039],{"class":1038},"s4XuR","helpful",[923,1041,1042],{"class":957},":",[923,1044,1045],{"class":986}," boolean",[923,1047,1048],{"class":929},") {\n",[923,1050,1052,1055,1058,1060,1063],{"class":925,"line":1051},10,[923,1053,1054],{"class":957},"  await",[923,1056,1057],{"class":937}," $fetch",[923,1059,1035],{"class":929},[923,1061,1062],{"class":947},"'\u002Fapi\u002Ffeedback'",[923,1064,1065],{"class":929},", {\n",[923,1067,1069,1072,1075],{"class":925,"line":1068},11,[923,1070,1071],{"class":929},"    method: ",[923,1073,1074],{"class":947},"'POST'",[923,1076,1077],{"class":929},",\n",[923,1079,1081],{"class":925,"line":1080},12,[923,1082,1083],{"class":929},"    body: { path: route.fullPath, helpful }\n",[923,1085,1087],{"class":925,"line":1086},13,[923,1088,1089],{"class":929},"  });\n",[923,1091,1093],{"class":925,"line":1092},14,[923,1094,1095],{"class":929},"}\n",[923,1097,1099,1102,1104],{"class":925,"line":1098},15,[923,1100,1101],{"class":929},"\u003C\u002F",[923,1103,934],{"class":933},[923,1105,951],{"class":929},[923,1107,1109],{"class":925,"line":1108},16,[923,1110,977],{"emptyLinePlaceholder":976},[923,1112,1114,1116,1119],{"class":925,"line":1113},17,[923,1115,930],{"class":929},[923,1117,1118],{"class":933},"template",[923,1120,951],{"class":929},[923,1122,1124,1127,1130,1133,1136,1138,1141,1144,1146],{"class":925,"line":1123},18,[923,1125,1126],{"class":929},"  \u003C",[923,1128,1129],{"class":933},"DuxtPageFeedbackBase",[923,1131,1132],{"class":929}," @",[923,1134,1135],{"class":937},"feedback",[923,1137,944],{"class":929},[923,1139,1140],{"class":947},"\"",[923,1142,1143],{"class":929},"onFeedback",[923,1145,1140],{"class":947},[923,1147,1148],{"class":929}," \u002F>\n",[923,1150,1152,1154,1156],{"class":925,"line":1151},19,[923,1153,1101],{"class":929},[923,1155,1118],{"class":933},[923,1157,951],{"class":929},[897,1159,1160,1163,1164,1274,1277,1278,1281],{},[900,1161,1162],{},"Give the answer somewhere to land."," A route of your own, so the reader's\nbrowser never talks to a third party you did not choose:",[914,1165,1170],{"className":1166,"code":1167,"filename":1168,"language":1169,"meta":919,"style":919},"language-ts shiki shiki-themes github-light github-dark","export default defineEventHandler(async (event) => {\n  const { path, helpful } = await readBody(event);\n\n  \u002F\u002F Your storage, your analytics, your queue.\n  await recordFeedback({ path, helpful });\n\n  return { ok: true };\n});\n","server\u002Fapi\u002Ffeedback.post.ts","ts",[905,1171,1172,1202,1232,1236,1241,1251,1255,1269],{"__ignoreMap":919},[923,1173,1174,1177,1180,1183,1185,1187,1190,1193,1196,1199],{"class":925,"line":926},[923,1175,1176],{"class":957},"export",[923,1178,1179],{"class":957}," default",[923,1181,1182],{"class":937}," defineEventHandler",[923,1184,1035],{"class":929},[923,1186,1026],{"class":957},[923,1188,1189],{"class":929}," (",[923,1191,1192],{"class":1038},"event",[923,1194,1195],{"class":929},") ",[923,1197,1198],{"class":957},"=>",[923,1200,1201],{"class":929}," {\n",[923,1203,1204,1207,1210,1213,1216,1218,1221,1223,1226,1229],{"class":925,"line":954},[923,1205,1206],{"class":957},"  const",[923,1208,1209],{"class":929}," { ",[923,1211,1212],{"class":986},"path",[923,1214,1215],{"class":929},", ",[923,1217,1039],{"class":986},[923,1219,1220],{"class":929}," } ",[923,1222,944],{"class":957},[923,1224,1225],{"class":957}," await",[923,1227,1228],{"class":937}," readBody",[923,1230,1231],{"class":929},"(event);\n",[923,1233,1234],{"class":925,"line":973},[923,1235,977],{"emptyLinePlaceholder":976},[923,1237,1238],{"class":925,"line":980},[923,1239,1240],{"class":1007},"  \u002F\u002F Your storage, your analytics, your queue.\n",[923,1242,1243,1245,1248],{"class":925,"line":999},[923,1244,1054],{"class":957},[923,1246,1247],{"class":937}," recordFeedback",[923,1249,1250],{"class":929},"({ path, helpful });\n",[923,1252,1253],{"class":925,"line":1004},[923,1254,977],{"emptyLinePlaceholder":976},[923,1256,1257,1260,1263,1266],{"class":925,"line":1011},[923,1258,1259],{"class":957},"  return",[923,1261,1262],{"class":929}," { ok: ",[923,1264,1265],{"class":986},"true",[923,1267,1268],{"class":929}," };\n",[923,1270,1271],{"class":925,"line":1017},[923,1272,1273],{"class":929},"});\n",[1275,1276],"br",{},"A client-side analytics call works the same way — replace the ",[905,1279,1280],{},"$fetch"," in the\nwrapper with whatever your provider's SDK exposes.",[897,1283,1284,1287],{},[900,1285,1286],{},"Rebuild and answer the question once",", then check that the answer arrived\nwith the path you expected — under a version prefix, not just at the bare\nURL.",[888,1289,1291],{"id":1290},"rendering-your-own-control","Rendering your own control",[884,1293,1294],{},"The event keeps the layer's buttons. To replace them, take the default slot\ninstead: it exposes the same state the component renders from, so the reset on\nnavigation and the \"thanks\" state stay the layer's job.",[914,1296,1298],{"className":916,"code":1297,"filename":907,"language":918,"meta":919,"style":919},"\u003Cscript setup lang=\"ts\">\nimport DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CDuxtPageFeedbackBase v-slot=\"{ answered, answer }\">\n    \u003Cform v-if=\"answered === undefined\" @submit.prevent=\"answer(true)\">\n      \u003Clabel>\n        Tell us what is missing\n        \u003Ctextarea name=\"comment\" \u002F>\n      \u003C\u002Flabel>\n      \u003Cbutton type=\"submit\">Send\u003C\u002Fbutton>\n    \u003C\u002Fform>\n    \u003Cp v-else>Thank you.\u003C\u002Fp>\n  \u003C\u002FDuxtPageFeedbackBase>\n\u003C\u002Ftemplate>\n",[905,1299,1300,1316,1328,1336,1340,1348,1368,1394,1404,1409,1431,1440,1462,1471,1487,1496],{"__ignoreMap":919},[923,1301,1302,1304,1306,1308,1310,1312,1314],{"class":925,"line":926},[923,1303,930],{"class":929},[923,1305,934],{"class":933},[923,1307,938],{"class":937},[923,1309,941],{"class":937},[923,1311,944],{"class":929},[923,1313,948],{"class":947},[923,1315,951],{"class":929},[923,1317,1318,1320,1322,1324,1326],{"class":925,"line":954},[923,1319,958],{"class":957},[923,1321,961],{"class":929},[923,1323,964],{"class":957},[923,1325,967],{"class":947},[923,1327,970],{"class":929},[923,1329,1330,1332,1334],{"class":925,"line":973},[923,1331,1101],{"class":929},[923,1333,934],{"class":933},[923,1335,951],{"class":929},[923,1337,1338],{"class":925,"line":980},[923,1339,977],{"emptyLinePlaceholder":976},[923,1341,1342,1344,1346],{"class":925,"line":999},[923,1343,930],{"class":929},[923,1345,1118],{"class":933},[923,1347,951],{"class":929},[923,1349,1350,1352,1354,1357,1359,1361,1364,1366],{"class":925,"line":1004},[923,1351,1126],{"class":929},[923,1353,1129],{"class":933},[923,1355,1356],{"class":937}," v-slot",[923,1358,944],{"class":929},[923,1360,1140],{"class":947},[923,1362,1363],{"class":929},"{ answered, answer }",[923,1365,1140],{"class":947},[923,1367,951],{"class":929},[923,1369,1370,1373,1376,1379,1381,1384,1387,1389,1392],{"class":925,"line":1011},[923,1371,1372],{"class":929},"    \u003C",[923,1374,1375],{"class":933},"form",[923,1377,1378],{"class":937}," v-if",[923,1380,944],{"class":929},[923,1382,1383],{"class":947},"\"answered === undefined\"",[923,1385,1386],{"class":937}," @submit.prevent",[923,1388,944],{"class":929},[923,1390,1391],{"class":947},"\"answer(true)\"",[923,1393,951],{"class":929},[923,1395,1396,1399,1402],{"class":925,"line":1017},[923,1397,1398],{"class":929},"      \u003C",[923,1400,1401],{"class":933},"label",[923,1403,951],{"class":929},[923,1405,1406],{"class":925,"line":1023},[923,1407,1408],{"class":929},"        Tell us what is missing\n",[923,1410,1411,1414,1417,1420,1422,1425,1429],{"class":925,"line":1051},[923,1412,1413],{"class":929},"        \u003C",[923,1415,1416],{"class":933},"textarea",[923,1418,1419],{"class":937}," name",[923,1421,944],{"class":929},[923,1423,1424],{"class":947},"\"comment\"",[923,1426,1428],{"class":1427},"s7hpK"," \u002F",[923,1430,951],{"class":929},[923,1432,1433,1436,1438],{"class":925,"line":1068},[923,1434,1435],{"class":929},"      \u003C\u002F",[923,1437,1401],{"class":933},[923,1439,951],{"class":929},[923,1441,1442,1444,1447,1450,1452,1455,1458,1460],{"class":925,"line":1080},[923,1443,1398],{"class":929},[923,1445,1446],{"class":933},"button",[923,1448,1449],{"class":937}," type",[923,1451,944],{"class":929},[923,1453,1454],{"class":947},"\"submit\"",[923,1456,1457],{"class":929},">Send\u003C\u002F",[923,1459,1446],{"class":933},[923,1461,951],{"class":929},[923,1463,1464,1467,1469],{"class":925,"line":1086},[923,1465,1466],{"class":929},"    \u003C\u002F",[923,1468,1375],{"class":933},[923,1470,951],{"class":929},[923,1472,1473,1475,1477,1480,1483,1485],{"class":925,"line":1092},[923,1474,1372],{"class":929},[923,1476,884],{"class":933},[923,1478,1479],{"class":937}," v-else",[923,1481,1482],{"class":929},">Thank you.\u003C\u002F",[923,1484,884],{"class":933},[923,1486,951],{"class":929},[923,1488,1489,1492,1494],{"class":925,"line":1098},[923,1490,1491],{"class":929},"  \u003C\u002F",[923,1493,1129],{"class":933},[923,1495,951],{"class":929},[923,1497,1498,1500,1502],{"class":925,"line":1108},[923,1499,1101],{"class":929},[923,1501,1118],{"class":933},[923,1503,951],{"class":929},[884,1505,1506,1509,1510,1513],{},[905,1507,1508],{},"answer(helpful)"," sets the state and emits the event, so a slot and a listener\ncompose: hang your form on the slot, and keep the ",[905,1511,1512],{},"@feedback"," handler from step 1\nto deliver what it collected.",[1515,1516,1519],"callout",{"title":1517,"type":1518},"Two answers are not two readers","warning",[884,1520,1521],{},"Nothing in the component identifies a visitor, and it deliberately stays that\nway. If you count answers per page, count them as answers — a browser that\nreloads and answers again is a second answer, not a second reader, and turning\none into the other is a consent question your privacy policy has to answer\nfirst.",[888,1523,1525],{"id":1524},"why-the-layer-stores-nothing","Why the layer stores nothing",[884,1527,1528,1529,1533],{},"A documentation theme that phoned home by default would have to pick a\ndestination for someone else's readers, and there is no defensible one: the\nlayer knows neither where your analytics live nor what your privacy policy\npromises. Shipping the question with an event and no backend keeps the decision\nwhere it belongs — the same reason the footer's legal row and the repository\nlinks ship empty (",[1530,1531,1532],"a",{"href":803},"ADR 0005",").",[888,1535,1537],{"id":1536},"checklist","Checklist",[1539,1540,1543,1552,1558,1564],"ul",{"className":1541},[1542],"contains-task-list",[897,1544,1547,1551],{"className":1545},[1546],"task-list-item",[1548,1549],"input",{"disabled":976,"type":1550},"checkbox"," The wrapper renders the layer's component rather than reimplementing it",[897,1553,1555,1557],{"className":1554},[1546],[1548,1556],{"disabled":976,"type":1550}," The answer is sent with the path it was given on, prefixes included",[897,1559,1561,1563],{"className":1560},[1546],[1548,1562],{"disabled":976,"type":1550}," The destination is yours — a route, a queue or an SDK you chose",[897,1565,1567,1569],{"className":1566},[1546],[1548,1568],{"disabled":976,"type":1550}," Nothing in the payload identifies the reader",[1571,1572,1573],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}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 .s7hpK, html code.shiki .s7hpK{--shiki-default:#B31D28;--shiki-default-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic}",{"title":919,"searchDepth":954,"depth":954,"links":1575},[1576,1577,1578,1579],{"id":890,"depth":954,"text":298},{"id":1290,"depth":954,"text":1291},{"id":1524,"depth":954,"text":1525},{"id":1536,"depth":954,"text":1537},[1581],{"name":1582,"commits":926},"Titus Kirch","md","2026-09-06T17:16:24+02:00",{},"---\ntitle: Collect page feedback\ndescription: Wrap DuxtPageFeedback, keep the answer where your analytics already live.\nicon: lucide:thumbs-up\n---\n\nEvery documentation page ends with \"Was this page helpful?\", and the layer does\nnothing with the answer: it holds it in the component's own state for the length\nof the visit, emits an event, and stores nothing. Wrapping the component is how\nthe answer reaches you.\n\n## Steps\n\n::steps\n\n1. **Wrap the layer's component under its own name.** Nuxt resolves your file\n   first, so `app\u002Fcomponents\u002FDuxtPageFeedback.vue` in your project replaces the\n   layer's — and the `@duxt` alias still reaches the original by path, so the\n   wrapper keeps the layer's markup, translations and reset-on-navigation:\n\n   ```vue [app\u002Fcomponents\u002FDuxtPageFeedback.vue]\n   \u003Cscript setup lang=\"ts\">\n   import DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\n   const route = useRoute();\n\n   \u002F\u002F The event carries the answer and nothing else — the page it belongs to is\n   \u002F\u002F yours to read, and `fullPath` is the one that keeps the locale, repository\n   \u002F\u002F and version prefixes the answer was actually given under.\n   async function onFeedback(helpful: boolean) {\n     await $fetch('\u002Fapi\u002Ffeedback', {\n       method: 'POST',\n       body: { path: route.fullPath, helpful }\n     });\n   }\n   \u003C\u002Fscript>\n\n   \u003Ctemplate>\n     \u003CDuxtPageFeedbackBase @feedback=\"onFeedback\" \u002F>\n   \u003C\u002Ftemplate>\n   ```\n\n2. **Give the answer somewhere to land.** A route of your own, so the reader's\n   browser never talks to a third party you did not choose:\n\n   ```ts [server\u002Fapi\u002Ffeedback.post.ts]\n   export default defineEventHandler(async (event) => {\n     const { path, helpful } = await readBody(event);\n\n     \u002F\u002F Your storage, your analytics, your queue.\n     await recordFeedback({ path, helpful });\n\n     return { ok: true };\n   });\n   ```\n\n   A client-side analytics call works the same way — replace the `$fetch` in the\n   wrapper with whatever your provider's SDK exposes.\n\n3. **Rebuild and answer the question once**, then check that the answer arrived\n   with the path you expected — under a version prefix, not just at the bare\n   URL.\n\n::\n\n## Rendering your own control\n\nThe event keeps the layer's buttons. To replace them, take the default slot\ninstead: it exposes the same state the component renders from, so the reset on\nnavigation and the \"thanks\" state stay the layer's job.\n\n```vue [app\u002Fcomponents\u002FDuxtPageFeedback.vue]\n\u003Cscript setup lang=\"ts\">\nimport DuxtPageFeedbackBase from '@duxt\u002Fcomponents\u002FDuxtPageFeedback.vue';\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CDuxtPageFeedbackBase v-slot=\"{ answered, answer }\">\n    \u003Cform v-if=\"answered === undefined\" @submit.prevent=\"answer(true)\">\n      \u003Clabel>\n        Tell us what is missing\n        \u003Ctextarea name=\"comment\" \u002F>\n      \u003C\u002Flabel>\n      \u003Cbutton type=\"submit\">Send\u003C\u002Fbutton>\n    \u003C\u002Fform>\n    \u003Cp v-else>Thank you.\u003C\u002Fp>\n  \u003C\u002FDuxtPageFeedbackBase>\n\u003C\u002Ftemplate>\n```\n\n`answer(helpful)` sets the state and emits the event, so a slot and a listener\ncompose: hang your form on the slot, and keep the `@feedback` handler from step 1\nto deliver what it collected.\n\n::callout{type=\"warning\" title=\"Two answers are not two readers\"}\nNothing in the component identifies a visitor, and it deliberately stays that\nway. If you count answers per page, count them as answers — a browser that\nreloads and answers again is a second answer, not a second reader, and turning\none into the other is a consent question your privacy policy has to answer\nfirst.\n::\n\n## Why the layer stores nothing\n\nA documentation theme that phoned home by default would have to pick a\ndestination for someone else's readers, and there is no defensible one: the\nlayer knows neither where your analytics live nor what your privacy policy\npromises. Shipping the question with an event and no backend keeps the decision\nwhere it belongs — the same reason the footer's legal row and the repository\nlinks ship empty ([ADR 0005](\u002Fadr\u002F0005-ship-the-layer-without-owner-specific-links)).\n\n## Checklist\n\n- [ ] The wrapper renders the layer's component rather than reimplementing it\n- [ ] The answer is sent with the path it was given on, prefixes included\n- [ ] The destination is yours — a route, a queue or an SDK you chose\n- [ ] Nothing in the payload identifies the reader\n",{"title":137,"description":141},{"loc":138},"sDn-nSX2R6gOTFbkU_vwTq9ctYrETHV8eSF613evBU8","en-GB","en-US",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1593},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1595},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1597},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1599},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1601},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1603},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1605},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1607},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1609},"\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":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1611},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m12 19l-7-7l7-7m7 7H5\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1613},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"\u002F>",{"left":833,"top":833,"width":834,"height":834,"rotate":833,"vFlip":835,"hFlip":835,"body":1615},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m9 18l6-6l-6-6\"\u002F>",1789004671223]