配置

`minidocs(options?)`

Astro integration，从 @minidocs/astro 默认导入，加在 astro.config.mjs 的 integrations 里。

选项	类型	默认值	作用
`fallback`	`Record<string, string \| string[]>`	`{}`	页面没有翻译时依次尝试的语言，比如 `{ en: 'zh' }`。需要 Astro 的 `i18n`
`markdown.directives`	`boolean`	`true`	是否支持 `:::tip[标题]` 提示框
`markdown.alerts`	`boolean`	`true`	是否支持 GitHub 的 `> [!TIP]` 提示框

minidocs 还会读取 Astro 配置里的这些项：

Astro 配置	影响
`i18n.locales`、`i18n.defaultLocale`	内容的语言目录和地址里的语言段。`locales` 只能是字符串
`i18n.routing.prefixDefaultLocale`	默认语言的地址是否带语言段
`base`、`trailingSlash`、`build.format`	链接的前缀和末尾斜杠
`site`	llms.txt 和 llms-full.txt 里的链接写成完整的 URL

不支持 i18n.routing: 'manual' 和 Astro 的 i18n.fallback，设置了会报错。

从 @minidocs/astro/loaders 导入。它是 Astro 的 glob loader，接受 Astro glob 的所有选项，另外有：

选项	类型	默认值	作用
`prefix`	`string`	站点根路径	页面所在的路径，比如 `docs` 表示页面在 `/docs/` 下
`filter`	`(entry) => boolean`		返回 `false` 的条目不会进入集合。`entry` 有 `id`、`data` 和 `filePath`，`data` 已经过 schema 校验

集合的 schema 里要有 title: string，它是页面在侧边栏和 llms.txt 里的标题。

用它加载的集合会生成页面 id 的类型，正文里的文件链接可以指向它，listPages、toHref、toMarkdown 也都可以用于它。两个集合的页面地址相同时，同步内容时会报错。