集合类型
了解 Nuxt Content 中常见的集合类型。
在 Nuxt Content 中,集合类型决定内容如何被解析、查询和使用。常见类型是 page 和 data。
page 类型
page 适合直接渲染为页面的内容,例如文档、博客文章、帮助中心文章和更新日志。
defineCollection({
type: 'page',
source: 'docs/**/*.md'
})
page 类型通常会包含页面路径、标题、描述、正文和 frontmatter 元数据。它适合配合动态路由生成实际页面。
适用场景:
- 文档页面
- 博客文章
- 更新日志
- 营销内容页
data 类型
data 适合结构化数据,不一定直接对应页面。例如导航配置、产品配置、价格表、FAQ 数据等。
defineCollection({
type: 'data',
source: 'data/**/*.yml'
})
适用场景:
- 页面配置
- 列表数据
- 产品参数
- 不需要直接生成路由的数据源
路径与排序
文件名可以通过数字前缀控制排序,例如:
1.introduction.md
2.installation.md
10.advanced.md
如果需要稳定排序,建议使用补零格式:
01.introduction.md
02.installation.md
10.advanced.md
选择建议
- 内容需要被访问和渲染为页面时,使用
page。 - 内容只是供组件查询和展示时,使用
data。 - 对外页面应保持完整 frontmatter,至少包含
title和description。 - 修改集合类型后,应检查查询代码、路由生成和 sitemap。
