集合
概述
Collections（集合） 是主题中用于组织和管理文档的核心概念。 每个集合指向源目录下的特定文件夹，将其中的所有 Markdown 文件作为一个逻辑单元进行管理。
通过灵活的集合配置，您可以轻松构建多种内容体系：
- 博客 - 个人随笔与技术分享
- 专栏 - 专题系列文章
- 使用手册 - 产品使用文档
- 笔记 - 学习笔记与知识整理
- 产品文档 - 完整的项目文档
- 知识库 - 团队知识管理体系
- 更多...
创建集合
一个普通的 VuePress 静态站点的文件结构大致如下：
.vuepress
…
README.md# 首页
package.json
当您想要添加一个用于 博客 的集合：
创建 blog 目录
post-1.md
post-2.md
…
…
在主题配置中添加类型为
post的集合将
dir配置项指向blog目录.vuepress/config.tsimport {defineUserConfig} from 'vuepress' import {plumeTheme} from 'vuepress-theme-plume' export defaultdefineUserConfig({theme:plumeTheme({collections: [ {type: 'post',dir: 'blog',title: '博客' } ] }) }).vuepress/plume.config.tsimport {defineThemeConfig} from 'vuepress-theme-plume' export defaultdefineThemeConfig({collections: [ {type: 'post',dir: 'blog',title: '博客' } ] })blog目录下的 Markdown 文章将被读取为文章列表，并自动生成列表页、分类页、标签页等页面。完成
在这其中，需要注意的是：
dir 配置项
集合配置中的
dir指向源目录下的某个文件夹，该文件夹下的所有 markdown 文件都将归属于该集合。type 配置项
集合配置中的
type指定了集合的类型。集合的类型决定了该集合下的文档将会提供哪些功能，当前主题支持的类型如下：
post：表示碎片化文章的集合，文章之间不存在关联关系或弱关联关系。doc: 表示结构化文章的集合，文章之间存在结构化的强关联关系，作为一个整体。
title 配置项
集合配置中的
title指定了集合的名称。在主题中，
title用于页面的面包屑导航中。
集合类型
集合的类型决定了该集合下的文档将会提供哪些功能。
关于 frontmatter
下表中提到的 frontmatter 是指 Markdown 文件顶部的 YAML 格式元数据，用于配置页面的标题、创建时间、标签、分类等信息。它由三根虚线 --- 包裹，例如：
---
title: 文章标题
createTime: 2024-01-01
tags:
- 标签1
- 标签2
---
正文内容...主题支持自动生成 frontmatter，详见 自动 Frontmatter。
| 特性 | post 集合 | doc 集合 |
|---|---|---|
| 适用场景 | 博客、随笔、碎片化文章 | 文档手册、系列教程、知识库 |
| 文章列表页 | ✅ 自动生成 | ❌ 不生成 |
| 分类页 | ✅ 根据目录结构生成 | ❌ 不生成 |
| 标签页 | ✅ 根据 frontmatter.tags 生成 | ❌ 不生成 |
| 归档页 | ✅ 根据 createTime 生成 | ❌ 不生成 |
| 侧边栏 | ❌ 不生成 | ✅ 自动生成或手动配置 |
| 目录结构 | 扁平化，文章间无强关联 | 层级化，文章间有结构化关联 |
| 自动 Frontmatter | ✅ 支持 title、createTime 等 | ✅ 支持 title、createTime 等 |
post 集合
post 集合提供了以下的功能实现：
- 文章列表页 - 文章置顶、文章封面图、文章摘要等。
- 文章分类页 - 根据目录结构自动生成分类。
- 文章标签页 - 根据页面
frontmatter.tags生成标签。 - 文章归档页 - 根据页面
frontmatter.createTime生成归档。
doc 集合
doc 集合提供了以下的功能实现：
- 侧边导航栏 - 提供清晰的文档结构导航
- 自动生成目录 - 基于文件结构智能生成侧边栏
- 多级嵌套支持 - 支持复杂的文档层次结构
已弃用
旧版本中的 notes 配置项已弃用，请使用 collections 配置代替。notes 将在未来的主版本中移除。
notes 配置中的目录和笔记结构可以对应迁移到 collections 中的 doc 类型集合，参考 集合配置 了解更多。
