集合
集合类型
了解你可以在 Nuxt Content 中定义的两种集合类型。
在 Nuxt Content 中，你可以根据集合文件的预期用途为每个集合指定一个类型。集合可以定义为 page（页面） 或 data（数据） 类型。
对于这两种类型，都会生成内置字段。每个集合都包含以下默认字段：
id: 唯一内容标识符stem: 不带扩展名的文件路径（用于排序和定位）extension: 文件扩展名meta: 不在集合模式中定义的自定义字段
页面类型
defineCollection({
source: '**/*.md',
type: 'page'
})
如果内容文件与网站页面之间是一对一关系，请使用 page 类型。
路径生成
Nuxt Content 会自动为集合中的每个文件生成路径，方便创建 URL 映射。
以下是基于文件结构生成的路径示例：
| 文件 | 路径 |
|---|---|
content/index.md | / |
content/about.md | /about |
content/blog/index.md | /blog |
content/blog/hello.md | /blog/hello |
content/1.guide/2.installation | /guide/installation |
你可以使用辅助函数
queryCollection('COLLECTION').path('PATH') 按特定路径检索内容。模式重写
当你使用 page 类型时，Nuxt Content 会生成几个常用于网页的标准字段。这些字段提供结构性，并且 会自动 应用于集合的模式：
path: 生成的路由路径title: 页面标题description: 页面描述seo: SEO 元数据（与 Nuxt 的useSeoMeta组合函数配合使用）body: 解析为 AST 的页面内容navigation: 页面导航配置（用于 queryCollectionNavigation）
对应应用的模式如下：
path: z.string(),
title: z.string(),
description: z.string(),
seo: z.intersection(
z.object({
title: z.string().optional(),
description: z.string().optional(),
meta: z.array(z.record(z.string(), z.any())).optional(),
link: z.array(z.record(z.string(), z.any())).optional(),
}),
z.record(z.string(), z.any()),
).optional().default({}),
body: z.object({
type: z.string(),
children: z.any(),
toc: z.any(),
}),
navigation: z.union([
z.boolean(),
z.object({
title: z.string(),
description: z.string(),
icon: z.string(),
}),
]).default(true),
你可以通过在集合模式中定义这些字段来覆盖它们。
数据类型
defineCollection({
source: 'authors/**.yml',
type: 'data'
})
数据类型适用于那些不直接对应网页，而是表示你可能想在应用中查询和展示的结构化数据的内容。
对于数据集合，你可以完全控制模式，自定义结构。
文件排序
对于这两种类型，你可能希望控制列表中的显示顺序。通过在文件和目录名称中使用数字前缀来指定顺序。Nuxt Content 会使用这些数字对内容列表进行排序。
Nuxt Content 使用字母顺序进行排序，因此如果需要使用数字顺序，单数字前请加
0 前缀。例如，不加 0 前缀时，10.foo.md 会排在 2.bar.md 前面。目录结构
content/
1.frameworks/
1.vue.md
2.nuxt.md
...
2.examples/
01.nuxthub.md
02.vercel.md
03.netlify.md
04.heroku.md
...
10.cloudflare.md
index.md
数字和文件名之间请使用
. 字符分隔。使用其他分隔符将无效。