站点配置参考

Canofold 从项目根目录加载一个 canofold.config.ts、.mts、.cts、.js、.mjs 或 .cjs。多个同名变体会被视为歧义，未知字段和非法值会直接报错。

import { defineConfig } from 'canofold'export default defineConfig({  title: 'Acme Docs',  description: 'Acme 平台开发文档',  siteUrl: 'https://docs.acme.com',  basePath: '/',  requiredVersion: '^0.6.5'})

defineConfig() 不会改写配置，只为整个对象及其嵌套字段提供类型检查和编辑器补全。直接导出对象仍然受构建期 Schema 校验。

站点与目录

siteUrl 只写 origin，子目录由 basePath 表达。editUrl 和 github 未确定时直接省略。关闭 layout.header 不会移除正文侧栏、页内导航或搜索快捷键。

Markdown

独立使用 <Markdown> 时，HTML 默认值是 strip，与 Canofold 站点配置的 sanitize 不同。接入方法见 Markdown，插件配置见官方插件。

单个代码围栏可用独立的 wrap 或 scroll 元数据覆盖站点默认值，例如 ```ts scroll。它可以与 title="file.ts"、行高亮和 diff 标记同时使用。

组件示例

Demo 引擎是 Canofold 的可替换能力，不改变项目原有构建工具。@canofold/vite 会读取已有 vite.config，并把 Vite 中间件和 HMR 接到 Canofold 的同一个开发服务器。完整用法见组件示例。

主题、品牌、布局与搜索

主题定义来自 @canofold/themes 或第三方包，负责本地化名称、CSS 入口和外观；Core 负责布局、行为、持久化和无障碍。主题配置见定制主题，搜索选择见配置搜索。

站点能力

对应流程见导航、版本、重定向、扩展和广告。

多语言与 AI 输出

添加语言见配置多语言，文件结构与收录规则见 AI 友好输出。

这些开关互不依赖；如果关闭 ai.fullContent，但 llms-full.txt 超过容量上限且使用 manifest 策略，构建会失败，因为不能指向不存在的 Manifest。可提高上限、关闭 ai.llmsFullTxt，或重新开启分片。