[{"data":1,"prerenderedAt":1339},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"mdc--tctnej-key":338,"docs--docs-guide-configuration":351,"surround--docs-guide-configuration":1328,"-docs-guide-configuration-description":1331},[4],{"title":5,"path":6,"stem":7,"children":8,"page":113},"Docs","\u002Fdocs","docs",[9,38,114,150,191,239],{"title":10,"path":11,"stem":12,"children":13,"category":16,"description":16,"icon":37},"开始","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[14,19,25,31],{"title":15,"path":11,"stem":12,"category":16,"description":17,"icon":18},"简介",null,"Movk Nuxt Docs 是一个可以直接 extends 的 Nuxt Layer，提供文档站所需的排版、导航、搜索、SEO 与 AI 能力。本页说明它适合什么项目、默认包含哪些功能、哪些功能按需开启。","i-lucide-book-open",{"title":20,"path":21,"stem":22,"category":16,"description":23,"icon":24},"安装","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F1.getting-started\u002F2.installation","用官方模板从零创建文档站，或把 @movk\u002Fnuxt-docs 作为 Layer 接入现有 Nuxt 项目。本页列出 default、i18n、module 三套模板的区别、运行环境要求与必须安装的依赖。","i-lucide-download",{"title":26,"path":27,"stem":28,"category":16,"description":29,"icon":30},"项目结构","\u002Fdocs\u002Fgetting-started\u002Fproject-structure","docs\u002F1.getting-started\u002F3.project-structure","说明使用 Movk Nuxt Docs 的项目中各目录与文件的职责：内容放在哪里、路由如何生成、哪些文件会被自动识别为版本发布页与案例页，以及两份配置文件分别管什么。","i-lucide-folder-tree",{"title":32,"path":33,"stem":34,"category":16,"description":35,"icon":36},"从 v2 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigration","docs\u002F1.getting-started\u002F4.migration","逐条列出从 @movk\u002Fnuxt-docs v2 升级到 v3 的破坏性变更，每项给出 v2 与 v3 写法对比。按顺序检查依赖与功能开关、内容目录、配置字段、视觉默认值和组件覆盖，即可完成升级。","i-lucide-arrow-right-left","i-lucide-square-play",{"title":39,"category":16,"description":16,"icon":40,"path":41,"stem":42,"children":43,"page":113},"指南","i-lucide-compass","\u002Fdocs\u002Fguide","docs\u002F2.guide",[44,51,58,64,70,76,82,89,95,101,107],{"title":45,"path":46,"stem":47,"category":48,"description":49,"icon":50},"配置总览","\u002Fdocs\u002Fguide\u002Fconfiguration","docs\u002F2.guide\u002F1.configuration","basics","Movk Nuxt Docs 的配置分为 nuxt.config.ts 与 app.config.ts 两处：前者在构建期决定启用哪些模块与功能，后者在运行时控制界面、文案与导航。本页说明两者的分工、生效时机，以及常见需求应该改哪一处。","i-lucide-settings",{"title":52,"path":53,"stem":54,"category":55,"description":56,"icon":57},"故障排查","\u002Fdocs\u002Fguide\u002Ftroubleshooting","docs\u002F2.guide\u002F10.troubleshooting","shipping","汇总可选依赖缺失、AI Chat 与 MCP 依赖关系、文档 404、多语言配置、pnpm 构建脚本审批与提交记录问题的解决办法。","i-lucide-life-buoy",{"title":59,"path":60,"stem":61,"category":55,"description":62,"icon":63},"常见问题","\u002Fdocs\u002Fguide\u002Ffaq","docs\u002F2.guide\u002F11.faq","关于 Movk Nuxt Docs 的常见疑问：与 Nuxt UI 文档模板的关系、包管理器与 Node.js 版本、单语言站点、关闭 GitHub 集成、接入其他 AI 厂商、升级与组件覆盖、静态部署的限制等，每条都链接到详细说明。","i-lucide-circle-help",{"title":65,"path":66,"stem":67,"category":48,"description":68,"icon":69},"主题与字体","\u002Fdocs\u002Fguide\u002Ftheme","docs\u002F2.guide\u002F2.theme","默认主题采用编辑风：暖灰纸面、朱红强调色、衬线标题与等宽元信息。本页说明默认配色与字体、如何通过 app.config 切换颜色与标题字体、引入中文衬线字体，以及访客主题面板与动效偏好的行为。","i-lucide-palette",{"title":71,"path":72,"stem":73,"category":48,"description":74,"icon":75},"导航与分类","\u002Fdocs\u002Fguide\u002Fnavigation","docs\u002F2.guide\u002F3.navigation","页头导航、移动端菜单与侧栏分组都在 app.config 中声明，文档目录结构则决定栏目条与侧栏的内容和顺序。本页说明各类导航的数据来源、多语言文案与链接前缀、侧栏分组规则，以及导航过滤与 ⌘K 搜索。","i-lucide-map",{"title":77,"path":78,"stem":79,"category":48,"description":80,"icon":81},"功能开关","\u002Fdocs\u002Fguide\u002Ffeatures","docs\u002F2.guide\u002F4.features","组件文档、Mermaid、AI Chat、无障碍检查等可选功能都由 nuxt.config 中的开关控制，默认关闭的功能不会打包任何相关依赖。本页列出每个开关的默认值、启用后需要安装的依赖，以及关闭时的降级行为。","i-lucide-toggle-right",{"title":83,"path":84,"stem":85,"category":86,"description":87,"icon":88},"自定义","\u002Fdocs\u002Fguide\u002Fcustomization","docs\u002F2.guide\u002F5.customization","customization","在项目组件目录中创建与内置组件同名的 Vue 文件，即可替换页头、侧栏、页脚等界面区域。本页列出 v3 承诺稳定的可覆盖组件、各自的挂载位置，并为每个组件给出最小覆盖示例。","i-lucide-paintbrush",{"title":90,"path":91,"stem":92,"category":86,"description":93,"icon":94},"页面与布局","\u002Fdocs\u002Fguide\u002Fpages","docs\u002F2.guide\u002F6.pages","除文档页外，Layer 会根据 content 目录中的文件自动生成首页、版本发布页与案例页，你也可以在 app\u002Fpages 中编写任意 Vue 页面。本页说明各内置路由的生成条件与内容格式、自定义页面的页头页脚开关，以及内置布局。","i-lucide-layout-panel-top",{"title":96,"path":97,"stem":98,"category":86,"description":99,"icon":100},"国际化","\u002Fdocs\u002Fguide\u002Fi18n","docs\u002F2.guide\u002F7.i18n","用 @nuxtjs\u002Fi18n 为文档站开启多语言：安装与配置、内容目录约定、按语言生成的内容集合、界面文案覆盖与 hreflang SEO。未配置时站点按单语言运行，也可只切换界面语言。","i-lucide-languages",{"title":102,"path":103,"stem":104,"category":86,"description":105,"icon":106},"OG 图片","\u002Fdocs\u002Fguide\u002Fog-image","docs\u002F2.guide\u002F8.og-image","每个文档页在构建时自动生成社交分享图片（OG 图片）。本页说明内置模板读取哪些字段、如何在自定义页面中生成、如何替换模板，以及关闭该功能后的行为。","i-lucide-image",{"title":108,"path":109,"stem":110,"category":55,"description":111,"icon":112},"部署","\u002Fdocs\u002Fguide\u002Fdeployment","docs\u002F2.guide\u002F9.deployment","把文档站部署到 Vercel、Netlify、Cloudflare 或任意 Node.js 服务器，也可以生成纯静态站点。本页列出构建命令、环境变量、各平台的注意事项，以及静态部署下不可用的功能。","i-lucide-rocket",false,{"title":115,"category":16,"description":16,"icon":116,"path":117,"stem":118,"children":119,"page":113},"AI","i-lucide-sparkles","\u002Fdocs\u002Fai","docs\u002F3.ai",[120,126,132,138,144],{"title":121,"path":122,"stem":123,"category":16,"description":124,"icon":125},"AI Chat","\u002Fdocs\u002Fai\u002Fai-chat","docs\u002F3.ai\u002F1.ai-chat","为文档站启用内置 AI 助手：说明启用条件与依赖安装、模型与端点路由的配置方式、如何接入其他厂商，以及组件与组合式函数的 API，帮助你在几分钟内让读者直接向文档提问。","i-lucide-bot",{"title":127,"path":128,"stem":129,"category":16,"description":130,"icon":131},"MCP Server","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F3.ai\u002F2.mcp","每个文档站默认在 \u002Fmcp 提供 Model Context Protocol 服务。本页列出内置的工具、资源与提示词，说明如何在 Claude Code、Cursor、VS Code 等客户端接入，以及如何关闭、限制或扩展服务器。","i-lucide-plug",{"title":133,"path":134,"stem":135,"category":16,"description":136,"icon":137},"Agent Skills","\u002Fdocs\u002Fai\u002Fskills","docs\u002F3.ai\u002F3.skills","把项目根目录 skills\u002F 下的 Agent Skills 随文档站一起发布到 \u002F.well-known\u002Fskills\u002F，读者一条命令即可安装到 Claude Code、Cursor 等助手。本页说明目录结构、命名规则、发布方式与内置的两个 Skill。","i-lucide-wand-sparkles",{"title":139,"path":140,"stem":141,"category":16,"description":142,"icon":143},"llms.txt","\u002Fdocs\u002Fai\u002Fllms-txt","docs\u002F3.ai\u002F4.llms-txt","文档站自动生成 \u002Fllms.txt 与 \u002Fllms-full.txt，为大语言模型提供站点目录与全文。本页说明默认值从哪里来、如何配置标题与分组、它们与每页 Markdown 表示的关系，以及在 Cursor 等工具中的用法。","i-lucide-file-text",{"title":145,"path":146,"stem":147,"category":16,"description":148,"icon":149},"代理发现","\u002Fdocs\u002Fai\u002Fagent-discovery","docs\u002F3.ai\u002F5.agent-discovery","文档站默认为 AI 代理提供每页的 Markdown 表示、Markdown 站点地图与一组 \u002F.well-known 发现文档，代理无需解析 HTML 就能找到并读取内容。本页列出全部端点、内容协商规则与 layer 的补充实现。","i-lucide-radar",{"title":151,"category":16,"description":16,"icon":152,"path":153,"stem":154,"children":155,"page":113},"写作","i-lucide-square-pilcrow","\u002Fdocs\u002Fwriting","docs\u002F4.writing",[156,162,168,174,179,185],{"title":157,"path":158,"stem":159,"category":16,"description":160,"icon":161},"Markdown 语法","\u002Fdocs\u002Fwriting\u002Fmarkdown-syntax","docs\u002F4.writing\u002F1.markdown-syntax","文档页面使用标准 Markdown 编写：标题决定目录与锚点，配合强调、链接、列表、表格与引用组织内容。本页列出常用语法及其在 Movk Nuxt Docs 中的渲染效果。","i-lucide-heading",{"title":163,"path":164,"stem":165,"category":16,"description":166,"icon":167},"代码块","\u002Fdocs\u002Fwriting\u002Fcode-blocks","docs\u002F4.writing\u002F2.code-blocks","代码块默认使用 github-light \u002F github-dark 高亮，支持文件名、行高亮、复制按钮与颜色、图标预览；用 code-group、code-tree 等组件组织多文件与长代码示例。","i-lucide-square-code",{"title":169,"path":170,"stem":171,"category":16,"description":172,"icon":173},"MDC 组件","\u002Fdocs\u002Fwriting\u002Fmdc-components","docs\u002F4.writing\u002F3.mdc-components","在 Markdown 中用 MDC 语法嵌入 Nuxt UI 的 Prose 组件：提示块、徽标、卡片、折叠面板、选项卡、步骤、字段说明、图标与按键，无需编写 Vue 代码即可组织更有层次的文档内容。","i-lucide-puzzle",{"title":175,"path":176,"stem":177,"category":16,"description":178,"icon":106},"图片与视频","\u002Fdocs\u002Fwriting\u002Fmedia","docs\u002F4.writing\u002F4.media","用 Markdown 图片语法插入远程或本地图片，用 `u-color-mode-image` 为亮色与暗色模式分别提供截图，用 `:video` 嵌入视频；本页同时说明图片放置位置与替代文本的写法。",{"title":180,"path":181,"stem":182,"category":16,"description":183,"icon":184},"Mermaid 图表","\u002Fdocs\u002Fwriting\u002Fmermaid","docs\u002F4.writing\u002F5.mermaid","开启 `movkNuxtDocs.mermaid` 并安装 mermaid 与 dompurify 后，语言为 `mermaid` 的代码块渲染为流程图、时序图、类图等图表，随亮暗主题切换，进入视口时才加载，并提供复制与全屏查看。","i-lucide-workflow",{"title":186,"path":187,"stem":188,"category":16,"description":189,"icon":190},"内容组件","\u002Fdocs\u002Fwriting\u002Fcontent-components","docs\u002F4.writing\u002F6.content-components","layer 在 Nuxt UI Prose 组件之外提供的内容组件：为元素添加入场动画的 Motion、动态星空背景 StarsBg，以及编辑式落地页使用的 LandingCover、LandingSection 等组件，均可直接在 Markdown 中使用。","i-lucide-sparkle",{"title":192,"category":16,"description":16,"icon":193,"path":194,"stem":195,"children":196,"page":113},"组件","i-lucide-component","\u002Fdocs\u002Fcomponents","docs\u002F5.components",[197,203,209,215,221,227,233],{"title":198,"path":199,"stem":200,"category":16,"description":201,"icon":202},"ComponentProps","\u002Fdocs\u002Fcomponents\u002Fcomponent-props","docs\u002F5.components\u002F1.component-props","在 Markdown 中用一行 `:component-props` 生成 Vue 组件的 Props 表格，名称、默认值、类型与 JSDoc 说明均来自 nuxt-component-meta 提取的元数据，组件改动后文档自动同步。","i-lucide-list",{"title":204,"path":205,"stem":206,"category":16,"description":207,"icon":208},"ComponentSlots","\u002Fdocs\u002Fcomponents\u002Fcomponent-slots","docs\u002F5.components\u002F2.component-slots","用一行 `:component-slots` 列出 Vue 组件的全部插槽，插槽名、作用域参数类型与 JSDoc 说明来自 `defineSlots` 的类型定义，无需手写插槽文档。","i-lucide-layout-panel-left",{"title":210,"path":211,"stem":212,"category":16,"description":213,"icon":214},"ComponentEmits","\u002Fdocs\u002Fcomponents\u002Fcomponent-emits","docs\u002F5.components\u002F3.component-emits","用一行 `:component-emits` 列出 Vue 组件的全部事件，事件名、参数签名与 JSDoc 说明来自 `defineEmits` 的类型定义，与 Props、Slots 表格配套组成完整 API 文档。","i-lucide-radio-tower",{"title":216,"path":217,"stem":218,"category":16,"description":219,"icon":220},"ComponentExample","\u002Fdocs\u002Fcomponents\u002Fcomponent-example","docs\u002F5.components\u002F4.component-example","用 `:component-example` 把示例目录中的 Vue 文件渲染为实时预览，并在下方展示带高亮的源码；支持行高亮、折叠、可调参数与仅客户端渲染，适合展示组件在真实场景下的组合用法。","i-lucide-app-window",{"title":222,"path":223,"stem":224,"category":16,"description":225,"icon":226},"ComponentCode","\u002Fdocs\u002Fcomponents\u002Fcomponent-code","docs\u002F5.components\u002F5.component-code","用 `::component-code` 以属性矩阵驱动任意已注册的 Vue 组件实时渲染，读者在预览上方切换属性值，下方的 Vue 代码片段同步更新，可直接复制使用。","i-lucide-sliders-horizontal",{"title":228,"path":229,"stem":230,"category":16,"description":231,"icon":232},"CommitChangelog","\u002Fdocs\u002Fcomponents\u002Fcommit-changelog","docs\u002F5.components\u002F6.commit-changelog","用 `:commit-changelog` 从 GitHub 拉取组件或源文件的提交记录，按版本分组展示为时间线；文件路径由组件名推导，可按目录、扩展名、命名格式与作者调整，一篇文档也可关联多个文件。","i-lucide-git-commit-horizontal",{"title":234,"path":235,"stem":236,"category":16,"description":237,"icon":238},"PageLastCommit","\u002Fdocs\u002Fcomponents\u002Fpage-last-commit","docs\u002F5.components\u002F7.page-last-commit","文档页导语下方的元信息行会显示当前 Markdown 文件的最后一次提交，包括时间、作者与提交信息；本页说明它的启用条件、日期格式配置与 PR squash merge 的作者识别。","i-lucide-history",{"title":240,"category":16,"description":16,"icon":241,"path":242,"stem":243,"children":244,"page":113},"参考","i-lucide-book-marked","\u002Fdocs\u002Freference","docs\u002F6.reference",[245,251,257,332],{"title":246,"path":247,"stem":248,"category":16,"description":249,"icon":250},"app.config 参考","\u002Fdocs\u002Freference\u002Fapp-config","docs\u002F6.reference\u002F1.app-config","app.config.ts 全部配置项的字段、类型、默认值与说明，由 layer 的 nuxt.schema.ts 自动生成，与发布版本保持一致。需要了解某一项的用法时，从这里跳转到对应指南。","i-lucide-file-cog",{"title":252,"path":253,"stem":254,"category":16,"description":255,"icon":256},"nuxt.config 选项","\u002Fdocs\u002Freference\u002Fnuxt-config","docs\u002F6.reference\u002F2.nuxt-config","Layer 在构建期读取的全部 nuxt.config 选项与环境变量，包括功能开关、AI Chat、组件元数据、MCP、llms.txt、代理发现与站点信息。修改这些选项后需要重新构建或重启开发服务器。","i-lucide-settings-2",{"title":258,"category":16,"description":16,"icon":259,"path":260,"stem":261,"children":262,"page":113},"组合式函数","i-lucide-square-function","\u002Fdocs\u002Freference\u002Fcomposables","docs\u002F6.reference\u002F3.composables",[263,268,274,280,286,292,298,304,310,315,321,327],{"title":264,"path":265,"stem":266,"category":16,"description":267,"icon":100},"useMovkI18n","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-movk-i18n","docs\u002F6.reference\u002F3.composables\u002F1.use-movk-i18n","统一的多语言访问入口。无论是否启用 @nuxtjs\u002Fi18n，都能用同一套 API 读取当前语言、翻译文案、生成带语言前缀的链接，并拿到当前语言对应的内容集合名与文档根路径。",{"title":269,"path":270,"stem":271,"category":16,"description":272,"icon":273},"useLocaleSeo","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-locale-seo","docs\u002F6.reference\u002F3.composables\u002F10.use-locale-seo","为多语言站点注入 hreflang alternate 链接、x-default 与 og:locale，让搜索引擎正确识别各语言版本。layer 的 app.vue 已全局调用；只有在项目中重写 app.vue 时需要自行调用。","i-lucide-globe",{"title":275,"path":276,"stem":277,"category":16,"description":278,"icon":279},"useFetchComponentMeta","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-meta","docs\u002F6.reference\u002F3.composables\u002F11.use-fetch-component-meta","读取 nuxt-component-meta 生成的组件元数据，包括 Props、Slots、Events 的类型与说明。ComponentProps 等组件文档组件都基于它实现，需要自行渲染组件 API 表格时直接调用。仅在开启组件文档功能时可用。","i-lucide-braces",{"title":281,"path":282,"stem":283,"category":16,"description":284,"icon":285},"useFetchComponentExample","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-example","docs\u002F6.reference\u002F3.composables\u002F12.use-fetch-component-example","读取 components\u002Fcontent\u002Fexamples 下示例组件的源码、文件路径与组件名。ComponentExample 用它展示示例代码，需要在自定义组件中显示示例源码时直接调用。仅在开启组件文档功能时可用。","i-lucide-file-code",{"title":287,"path":288,"stem":289,"category":16,"description":290,"icon":291},"useDocsNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-navigation","docs\u002F6.reference\u002F3.composables\u002F2.use-docs-navigation","读取外壳预先加载好的文档导航树。页头栏目条、侧栏和文档页都从这里拿导航数据，自定义组件调用它即可复用同一份数据，不会再次查询内容集合。","i-lucide-list-tree",{"title":293,"path":294,"stem":295,"category":16,"description":296,"icon":297},"useNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-navigation","docs\u002F6.reference\u002F3.composables\u002F3.use-navigation","把文档导航树加工成侧栏需要的形态：取出顶层栏目、把当前栏目的页面按 docs.categories 分组，并为任意路径生成面包屑。自定义侧栏或目录组件时用它保持与默认实现一致的分组规则。","i-lucide-panel-left",{"title":299,"path":300,"stem":301,"category":16,"description":302,"icon":303},"useHeader","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-header","docs\u002F6.reference\u002F3.composables\u002F4.use-header","提供页头桌面端与移动端导航链接。推荐直接在 app.config 的 header.nav 与 header.mobileNav 中声明；需要按运行时状态动态生成链接时，再在项目中创建同名 composable 覆盖它。","i-lucide-panel-top",{"title":305,"path":306,"stem":307,"category":16,"description":308,"icon":309},"useCategory","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-category","docs\u002F6.reference\u002F3.composables\u002F5.use-category","提供侧栏分类定义，决定栏目内带 category 的页面如何分组、按什么顺序显示。推荐在 app.config 的 docs.categories 中声明；只有分类需要在运行时计算时，才在项目中创建同名 composable 覆盖。","i-lucide-folders",{"title":311,"path":312,"stem":313,"category":16,"description":314,"icon":69},"useTheme","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-theme","docs\u002F6.reference\u002F3.composables\u002F6.use-theme","主题面板背后的状态与操作：主色、中性色、圆角、图标集、黑色主色与颜色模式，访客的选择保存在 localStorage，并能导出为 app.config 或 CSS 片段。自定义主题面板或在页面中切换主题时使用。",{"title":316,"path":317,"stem":318,"category":16,"description":319,"icon":320},"useDocsRoute","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-route","docs\u002F6.reference\u002F3.composables\u002F7.use-docs-route","判断当前路由是否是文档子页面，兼容默认语言的 \u002Fdocs\u002F* 与其他语言的 \u002F{locale}\u002Fdocs\u002F*。自定义页头、页脚等全站组件需要只在文档页显示某些内容时使用。","i-lucide-route",{"title":322,"path":323,"stem":324,"category":16,"description":325,"icon":326},"useDocsFilterConfig","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-filter-config","docs\u002F6.reference\u002F3.composables\u002F8.use-docs-filter-config","侧栏导航过滤框的配置、显示条件与过滤函数，对应 app.config 的 aside.filter。自定义侧栏顶部或侧栏主体组件时，用这些函数保持与默认过滤行为一致。","i-lucide-list-filter",{"title":328,"path":329,"stem":330,"category":16,"description":331,"icon":220},"useDocsShell","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-shell","docs\u002F6.reference\u002F3.composables\u002F9.use-docs-shell","app.vue 与 error.vue 共用的站点外壳：按当前语言加载导航树与搜索索引，注入 html 语言、方向、字体与颗粒属性，并向组件树提供导航。只有在项目中完全重写 app.vue 或 error.vue 时才需要直接调用它。",{"title":333,"path":334,"stem":335,"category":16,"description":336,"icon":337},"A–Z 索引","\u002Fdocs\u002Freference\u002Fa-z","docs\u002F6.reference\u002F9.a-z","按英文标题首字母列出全部文档页面，记得功能名称却不确定它在哪个分区时，从这里直接跳转；中文页面同时显示英文标题以便按字母查找。","i-lucide-list-ordered",{"data":339,"body":340},{},{"type":341,"children":342},"root",[343],{"type":344,"tag":345,"props":346,"children":347},"element","p",{},[348],{"type":349,"value":350},"text","Copyright © 2024 - 2026",{"id":352,"title":45,"body":353,"category":48,"description":49,"difficulty":16,"extension":962,"index":113,"keywords":16,"links":16,"meta":1321,"navigation":1322,"path":46,"requires":16,"seo":1323,"sitemap":1326,"stem":47,"__hash__":1327},"docs\u002Fdocs\u002F2.guide\u002F1.configuration.md",{"type":354,"value":355,"toc":1313},"minimark",[356,360,422,440,453,456,459,642,645,756,759,890,894,900,1022,1035,1039,1052,1098,1109,1122,1125,1303,1309],[357,358,359],"h2",{"id":359},"两个配置文件",[361,362,363,382],"table",{},[364,365,366],"thead",{},[367,368,369,373,376,379],"tr",{},[370,371,372],"th",{},"文件",[370,374,375],{},"生效时机",[370,377,378],{},"负责内容",[370,380,381],{},"完整参考",[383,384,385,405],"tbody",{},[367,386,387,394,397,400],{},[388,389,390],"td",{},[391,392,393],"code",{},"nuxt.config.ts",[388,395,396],{},"构建期",[388,398,399],{},"继承 Layer、功能开关、AI 模型、MCP、llms.txt、国际化、站点地址",[388,401,402],{},[403,404,252],"a",{"href":253},[367,406,407,412,415,418],{},[388,408,409],{},[391,410,411],{},"app\u002Fapp.config.ts",[388,413,414],{},"运行时",[388,416,417],{},"页头、页脚、导航、侧栏分类、目录、主题、GitHub 集成、AI Chat 界面文案",[388,419,420],{},[403,421,246],{"href":247},[345,423,424,425,429,430,432,433,429,436,439],{},"判断改哪一处的规则很简单：会影响",[426,427,428],"strong",{},"打包了哪些代码、生成哪些路由与文件","的，放 ",[391,431,393],{},"；只影响",[426,434,435],{},"页面上显示什么",[391,437,438],{},"app.config.ts","。",[441,442,444,446,447,450,451,439],"note",{"to":443},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002F4.x\u002Fdirectory-structure\u002Fapp\u002Fapp-config",[391,445,438],{}," 需要位于 ",[391,448,449],{},"app\u002F"," 目录下，并且项目根目录必须存在 ",[391,452,393],{},[357,454,455],{"id":455},"最小配置",[345,457,458],{},"继承 Layer 后，大多数站点只需要补充站点名称与导航：",[460,461,462,543],"code-group",{},[463,464,469],"pre",{"className":465,"code":466,"filename":393,"language":467,"meta":468,"style":468},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineNuxtConfig({\n  extends: ['@movk\u002Fnuxt-docs'],\n  site: {\n    name: 'My Docs',\n    url: 'https:\u002F\u002Fdocs.example.com'\n  }\n})\n","ts","",[391,470,471,491,504,510,522,531,537],{"__ignoreMap":468},[472,473,476,480,483,487],"span",{"class":474,"line":475},"line",1,[472,477,479],{"class":478},"s8jYJ","export",[472,481,482],{"class":478}," default",[472,484,486],{"class":485},"snPdu"," defineNuxtConfig",[472,488,490],{"class":489},"sxrX7","({\n",[472,492,494,497,501],{"class":474,"line":493},2,[472,495,496],{"class":489},"  extends: [",[472,498,500],{"class":499},"sIIMD","'@movk\u002Fnuxt-docs'",[472,502,503],{"class":489},"],\n",[472,505,507],{"class":474,"line":506},3,[472,508,509],{"class":489},"  site: {\n",[472,511,513,516,519],{"class":474,"line":512},4,[472,514,515],{"class":489},"    name: ",[472,517,518],{"class":499},"'My Docs'",[472,520,521],{"class":489},",\n",[472,523,525,528],{"class":474,"line":524},5,[472,526,527],{"class":489},"    url: ",[472,529,530],{"class":499},"'https:\u002F\u002Fdocs.example.com'\n",[472,532,534],{"class":474,"line":533},6,[472,535,536],{"class":489},"  }\n",[472,538,540],{"class":474,"line":539},7,[472,541,542],{"class":489},"})\n",[463,544,546],{"className":465,"code":545,"filename":411,"language":467,"meta":468,"style":468},"export default defineAppConfig({\n  header: {\n    nav: [\n      { label: '文档', to: '\u002Fdocs\u002Fgetting-started', activeMatch: '\u002Fdocs' },\n      { label: '版本发布', to: '\u002Freleases' }\n    ]\n  },\n  footer: {\n    credits: 'Copyright © 2026 My Team'\n  }\n})\n",[391,547,548,559,564,569,592,607,612,617,623,632,637],{"__ignoreMap":468},[472,549,550,552,554,557],{"class":474,"line":475},[472,551,479],{"class":478},[472,553,482],{"class":478},[472,555,556],{"class":485}," defineAppConfig",[472,558,490],{"class":489},[472,560,561],{"class":474,"line":493},[472,562,563],{"class":489},"  header: {\n",[472,565,566],{"class":474,"line":506},[472,567,568],{"class":489},"    nav: [\n",[472,570,571,574,577,580,583,586,589],{"class":474,"line":512},[472,572,573],{"class":489},"      { label: ",[472,575,576],{"class":499},"'文档'",[472,578,579],{"class":489},", to: ",[472,581,582],{"class":499},"'\u002Fdocs\u002Fgetting-started'",[472,584,585],{"class":489},", activeMatch: ",[472,587,588],{"class":499},"'\u002Fdocs'",[472,590,591],{"class":489}," },\n",[472,593,594,596,599,601,604],{"class":474,"line":524},[472,595,573],{"class":489},[472,597,598],{"class":499},"'版本发布'",[472,600,579],{"class":489},[472,602,603],{"class":499},"'\u002Freleases'",[472,605,606],{"class":489}," }\n",[472,608,609],{"class":474,"line":533},[472,610,611],{"class":489},"    ]\n",[472,613,614],{"class":474,"line":539},[472,615,616],{"class":489},"  },\n",[472,618,620],{"class":474,"line":619},8,[472,621,622],{"class":489},"  footer: {\n",[472,624,626,629],{"class":474,"line":625},9,[472,627,628],{"class":489},"    credits: ",[472,630,631],{"class":499},"'Copyright © 2026 My Team'\n",[472,633,635],{"class":474,"line":634},10,[472,636,536],{"class":489},[472,638,640],{"class":474,"line":639},11,[472,641,542],{"class":489},[345,643,644],{},"未配置的字段使用 Layer 的默认值。以下几项会在构建期自动推断：",[361,646,647,657],{},[364,648,649],{},[367,650,651,654],{},[370,652,653],{},"字段",[370,655,656],{},"来源",[383,658,659,676,693,705,724,738],{},[367,660,661,666],{},[388,662,663],{},[391,664,665],{},"site.name",[388,667,668,671,672,675],{},[391,669,670],{},"package.json"," 的 ",[391,673,674],{},"name","，其次是 Git 仓库名",[367,677,678,683],{},[388,679,680],{},[391,681,682],{},"site.url",[388,684,685,688,689,692],{},[391,686,687],{},"NUXT_PUBLIC_SITE_URL","、",[391,690,691],{},"NUXT_SITE_URL","，或 Vercel、Netlify、Cloudflare Pages、GitLab Pages 注入的部署地址",[367,694,695,700],{},[388,696,697],{},[391,698,699],{},"header.title",[388,701,702,704],{},[391,703,665],{}," 转为首字母大写",[367,706,707,716],{},[388,708,709,712,713],{},[391,710,711],{},"seo.title"," \u002F ",[391,714,715],{},"seo.titleTemplate",[388,717,718,720,721],{},[391,719,665],{},"，标题模板为 ",[391,722,723],{},"%s - {site.name}",[367,725,726,731],{},[388,727,728],{},[391,729,730],{},"seo.description",[388,732,733,671,735],{},[391,734,670],{},[391,736,737],{},"description",[367,739,740,753],{},[388,741,742,712,745,712,747,712,750],{},[391,743,744],{},"github.owner",[391,746,674],{},[391,748,749],{},"url",[391,751,752],{},"branch",[388,754,755],{},"本地 Git 信息或 CI 环境变量",[357,757,758],{"id":758},"常见任务",[361,760,761,774],{},[364,762,763],{},[367,764,765,768,771],{},[370,766,767],{},"想做的事",[370,769,770],{},"改哪里",[370,772,773],{},"详见",[383,775,776,799,818,838,854,874],{},[367,777,778,781,795],{},[388,779,780],{},"修改页头导航、移动端菜单、侧栏分组",[388,782,783,671,786,688,789,688,792],{},[391,784,785],{},"app.config",[391,787,788],{},"header.nav",[391,790,791],{},"header.mobileNav",[391,793,794],{},"docs.categories",[388,796,797],{},[403,798,71],{"href":72},[367,800,801,804,814],{},[388,802,803],{},"更换主色、中性色、标题字体",[388,805,806,671,808,688,811],{},[391,807,785],{},[391,809,810],{},"ui.colors",[391,812,813],{},"theme.*",[388,815,816],{},[403,817,65],{"href":66},[367,819,820,823,834],{},[388,821,822],{},"启用组件文档、Mermaid、AI Chat",[388,824,825,671,828,688,831],{},[391,826,827],{},"nuxt.config",[391,829,830],{},"movkNuxtDocs.*",[391,832,833],{},"aiChat.*",[388,835,836],{},[403,837,77],{"href":78},[367,839,840,843,850],{},[388,841,842],{},"替换页头 Logo、页脚等界面区域",[388,844,845,846,849],{},"在 ",[391,847,848],{},"app\u002Fcomponents\u002F"," 中创建同名组件",[388,851,852],{},[403,853,83],{"href":84},[367,855,856,859,870],{},[388,857,858],{},"添加版本发布页、案例页、自定义页面",[388,860,861,688,864,688,867],{},[391,862,863],{},"content\u002Freleases.yml",[391,865,866],{},"content\u002Ftemplates.yml",[391,868,869],{},"app\u002Fpages\u002F",[388,871,872],{},[403,873,90],{"href":91},[367,875,876,879,886],{},[388,877,878],{},"支持多语言",[388,880,881,671,883],{},[391,882,827],{},[391,884,885],{},"i18n",[388,887,888],{},[403,889,96],{"href":97},[357,891,893],{"id":892},"seo","SEO",[345,895,896,897,899],{},"全站默认值写在 ",[391,898,438],{},"，单页覆盖写在 Markdown 的 frontmatter：",[460,901,902,957],{},[463,903,905],{"className":465,"code":904,"filename":411,"language":467,"meta":468,"style":468},"export default defineAppConfig({\n  seo: {\n    titleTemplate: '%s - My Docs',\n    title: 'My Docs',\n    description: '一句话介绍你的项目'\n  }\n})\n",[391,906,907,917,922,932,941,949,953],{"__ignoreMap":468},[472,908,909,911,913,915],{"class":474,"line":475},[472,910,479],{"class":478},[472,912,482],{"class":478},[472,914,556],{"class":485},[472,916,490],{"class":489},[472,918,919],{"class":474,"line":493},[472,920,921],{"class":489},"  seo: {\n",[472,923,924,927,930],{"class":474,"line":506},[472,925,926],{"class":489},"    titleTemplate: ",[472,928,929],{"class":499},"'%s - My Docs'",[472,931,521],{"class":489},[472,933,934,937,939],{"class":474,"line":512},[472,935,936],{"class":489},"    title: ",[472,938,518],{"class":499},[472,940,521],{"class":489},[472,942,943,946],{"class":474,"line":524},[472,944,945],{"class":489},"    description: ",[472,947,948],{"class":499},"'一句话介绍你的项目'\n",[472,950,951],{"class":474,"line":533},[472,952,536],{"class":489},[472,954,955],{"class":474,"line":539},[472,956,542],{"class":489},[463,958,963],{"className":959,"code":960,"filename":961,"language":962,"meta":468,"style":468},"language-md shiki shiki-themes github-light github-light github-dark","---\ntitle: 简介\ndescription: 页面导语，同时作为默认的 meta description。\nseo:\n  title: Introduction\n  description: 搜索引擎与社交卡片使用的描述。\n---\n","content\u002Fdocs\u002F1.getting-started\u002F1.index.md","md",[391,964,965,970,982,991,998,1008,1018],{"__ignoreMap":468},[472,966,967],{"class":474,"line":475},[472,968,969],{"class":489},"---\n",[472,971,972,976,979],{"class":474,"line":493},[472,973,975],{"class":974},"sovSZ","title",[472,977,978],{"class":489},": ",[472,980,981],{"class":499},"简介\n",[472,983,984,986,988],{"class":474,"line":506},[472,985,737],{"class":974},[472,987,978],{"class":489},[472,989,990],{"class":499},"页面导语，同时作为默认的 meta description。\n",[472,992,993,995],{"class":474,"line":512},[472,994,892],{"class":974},[472,996,997],{"class":489},":\n",[472,999,1000,1003,1005],{"class":474,"line":524},[472,1001,1002],{"class":974},"  title",[472,1004,978],{"class":489},[472,1006,1007],{"class":499},"Introduction\n",[472,1009,1010,1013,1015],{"class":474,"line":533},[472,1011,1012],{"class":974},"  description",[472,1014,978],{"class":489},[472,1016,1017],{"class":499},"搜索引擎与社交卡片使用的描述。\n",[472,1019,1020],{"class":474,"line":539},[472,1021,969],{"class":489},[345,1023,1024,1025,1028,1029,1031,1032,1034],{},"文档页的 ",[391,1026,1027],{},"\u003Ctitle>"," 与 OG 图片优先使用 ",[391,1030,711],{},"，未设置时回退到 ",[391,1033,975],{},"；描述同理。",[357,1036,1038],{"id":1037},"github-集成","GitHub 集成",[345,1040,1041,1042,1044,1045,1047,1048,1051],{},"Layer 从本地 Git 信息推断仓库地址，用于页头 GitHub 图标、「查看源码 \u002F 编辑此页」链接、",[391,1043,234],{}," 与 ",[391,1046,228],{},"。文档不在仓库根目录时需要指定 ",[391,1049,1050],{},"rootDir","：",[463,1053,1055],{"className":465,"code":1054,"filename":411,"language":467,"meta":468,"style":468},"export default defineAppConfig({\n  github: {\n    rootDir: 'docs',\n    branch: 'main'\n  }\n})\n",[391,1056,1057,1067,1072,1082,1090,1094],{"__ignoreMap":468},[472,1058,1059,1061,1063,1065],{"class":474,"line":475},[472,1060,479],{"class":478},[472,1062,482],{"class":478},[472,1064,556],{"class":485},[472,1066,490],{"class":489},[472,1068,1069],{"class":474,"line":493},[472,1070,1071],{"class":489},"  github: {\n",[472,1073,1074,1077,1080],{"class":474,"line":506},[472,1075,1076],{"class":489},"    rootDir: ",[472,1078,1079],{"class":499},"'docs'",[472,1081,521],{"class":489},[472,1083,1084,1087],{"class":474,"line":512},[472,1085,1086],{"class":489},"    branch: ",[472,1088,1089],{"class":499},"'main'\n",[472,1091,1092],{"class":474,"line":524},[472,1093,536],{"class":489},[472,1095,1096],{"class":474,"line":533},[472,1097,542],{"class":489},[345,1099,1100,1101,1104,1105,1108],{},"设置 ",[391,1102,1103],{},"github: false"," 可完全关闭集成。生产环境请配置 ",[391,1106,1107],{},"NUXT_GITHUB_TOKEN","，避免 GitHub API 匿名请求的频率限制。",[1110,1111,1112,688,1115,688,1118,1121],"tip",{"to":247},[391,1113,1114],{},"github.since",[391,1116,1117],{},"github.perPage",[391,1119,1120],{},"github.dateFormat"," 等全部字段见 app.config 参考。",[357,1123,1124],{"id":1124},"目录与页脚",[463,1126,1128],{"className":465,"code":1127,"filename":411,"language":467,"meta":468,"style":468},"export default defineAppConfig({\n  toc: {\n    title: '本页内容',\n    bottom: {\n      title: '社区',\n      links: [\n        { icon: 'i-lucide-book-open', label: 'Nuxt UI', to: 'https:\u002F\u002Fui.nuxt.com', target: '_blank' }\n      ]\n    }\n  },\n  footer: {\n    credits: 'Copyright © 2026 My Team · \u003Cspan class=\"text-highlighted\">MIT License\u003C\u002Fspan>',\n    socials: [\n      { 'icon': 'i-simple-icons-github', 'to': 'https:\u002F\u002Fgithub.com\u002Fmy\u002Frepo', 'target': '_blank', 'aria-label': 'GitHub' }\n    ]\n  }\n})\n",[391,1129,1130,1140,1145,1154,1159,1169,1174,1205,1210,1215,1219,1223,1233,1239,1288,1293,1298],{"__ignoreMap":468},[472,1131,1132,1134,1136,1138],{"class":474,"line":475},[472,1133,479],{"class":478},[472,1135,482],{"class":478},[472,1137,556],{"class":485},[472,1139,490],{"class":489},[472,1141,1142],{"class":474,"line":493},[472,1143,1144],{"class":489},"  toc: {\n",[472,1146,1147,1149,1152],{"class":474,"line":506},[472,1148,936],{"class":489},[472,1150,1151],{"class":499},"'本页内容'",[472,1153,521],{"class":489},[472,1155,1156],{"class":474,"line":512},[472,1157,1158],{"class":489},"    bottom: {\n",[472,1160,1161,1164,1167],{"class":474,"line":524},[472,1162,1163],{"class":489},"      title: ",[472,1165,1166],{"class":499},"'社区'",[472,1168,521],{"class":489},[472,1170,1171],{"class":474,"line":533},[472,1172,1173],{"class":489},"      links: [\n",[472,1175,1176,1179,1186,1189,1192,1194,1197,1200,1203],{"class":474,"line":539},[472,1177,1178],{"class":489},"        { icon: ",[472,1180,1181,1185],{"class":499},[1182,1183],"i",{"class":1184},"shiki-icon-highlight sIu1a","'i-lucide-book-open'",[472,1187,1188],{"class":489},", label: ",[472,1190,1191],{"class":499},"'Nuxt UI'",[472,1193,579],{"class":489},[472,1195,1196],{"class":499},"'https:\u002F\u002Fui.nuxt.com'",[472,1198,1199],{"class":489},", target: ",[472,1201,1202],{"class":499},"'_blank'",[472,1204,606],{"class":489},[472,1206,1207],{"class":474,"line":619},[472,1208,1209],{"class":489},"      ]\n",[472,1211,1212],{"class":474,"line":625},[472,1213,1214],{"class":489},"    }\n",[472,1216,1217],{"class":474,"line":634},[472,1218,616],{"class":489},[472,1220,1221],{"class":474,"line":639},[472,1222,622],{"class":489},[472,1224,1226,1228,1231],{"class":474,"line":1225},12,[472,1227,628],{"class":489},[472,1229,1230],{"class":499},"'Copyright © 2026 My Team · \u003Cspan class=\"text-highlighted\">MIT License\u003C\u002Fspan>'",[472,1232,521],{"class":489},[472,1234,1236],{"class":474,"line":1235},13,[472,1237,1238],{"class":489},"    socials: [\n",[472,1240,1242,1245,1248,1250,1256,1259,1262,1264,1267,1269,1272,1274,1276,1278,1281,1283,1286],{"class":474,"line":1241},14,[472,1243,1244],{"class":489},"      { ",[472,1246,1247],{"class":499},"'icon'",[472,1249,978],{"class":489},[472,1251,1252,1255],{"class":499},[1182,1253],{"class":1254},"shiki-icon-highlight sKSzO","'i-simple-icons-github'",[472,1257,1258],{"class":489},", ",[472,1260,1261],{"class":499},"'to'",[472,1263,978],{"class":489},[472,1265,1266],{"class":499},"'https:\u002F\u002Fgithub.com\u002Fmy\u002Frepo'",[472,1268,1258],{"class":489},[472,1270,1271],{"class":499},"'target'",[472,1273,978],{"class":489},[472,1275,1202],{"class":499},[472,1277,1258],{"class":489},[472,1279,1280],{"class":499},"'aria-label'",[472,1282,978],{"class":489},[472,1284,1285],{"class":499},"'GitHub'",[472,1287,606],{"class":489},[472,1289,1291],{"class":474,"line":1290},15,[472,1292,611],{"class":489},[472,1294,1296],{"class":474,"line":1295},16,[472,1297,536],{"class":489},[472,1299,1301],{"class":474,"line":1300},17,[472,1302,542],{"class":489},[345,1304,1305,1308],{},[391,1306,1307],{},"footer.credits"," 按 MDC 渲染，可以包含链接与行内 HTML。目录底部会自动追加 GitHub 的「编辑此页」链接。",[1310,1311,1312],"style",{},"html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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 .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sIu1a, html code.shiki .sIu1a{--shiki-icon-url:url(https:\u002F\u002Fapi.iconify.design\u002Flucide\u002Fbook-open.svg?color=%23000)}html pre.shiki code .sKSzO, html code.shiki .sKSzO{--shiki-icon-url:url(https:\u002F\u002Fapi.iconify.design\u002Fsimple-icons\u002Fgithub.svg?color=%23000)}",{"title":468,"searchDepth":493,"depth":493,"links":1314},[1315,1316,1317,1318,1319,1320],{"id":359,"depth":493,"text":359},{"id":455,"depth":493,"text":455},{"id":758,"depth":493,"text":758},{"id":892,"depth":493,"text":893},{"id":1037,"depth":493,"text":1038},{"id":1124,"depth":493,"text":1124},{},{"icon":50},{"title":1324,"description":1325},"Configuration Overview","Understand how Movk Nuxt Docs splits configuration between nuxt.config.ts for build-time modules and app.config.ts for runtime UI, text and navigation.",{"loc":46},"9iZ_BfJKn73YI2LA_5uTSebs_UsjR_TkdRXHdSSCQKY",[1329,1330],{"title":32,"path":33,"stem":34,"description":35,"icon":36,"children":-1},{"title":52,"path":53,"stem":54,"description":56,"icon":57,"children":-1},{"data":1332,"body":1333},{},{"type":341,"children":1334},[1335],{"type":344,"tag":345,"props":1336,"children":1337},{},[1338],{"type":349,"value":49},1794996143872]