集合类型

了解 Nuxt Content 中常见的集合类型。

在 Nuxt Content 中,集合类型决定内容如何被解析、查询和使用。常见类型是 pagedata

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,至少包含 titledescription
  • 修改集合类型后,应检查查询代码、路由生成和 sitemap。