分类 / 标签 / 归档

分类页 / 标签页 / 归档页共用 GroupView，通过 Props 传入不同的 type 来区分不同页面。

分类 / 标签

首先需要在 frontmatter 中，为文章设置分类或标签

category: 分类 A
tags: 
  - 标签 A
  - 标签 B

当有文章设置了分类或标签，主题会根据 outDir （默认为根目录）自动生成 category.md 与 tags.md

归档

归档页面需要手动创建，在 outDir 对应的目录（默认为根目录）新建 archives.md，并填入以下内容

---
title: 归档
layout: page
---
<Group type='archives' lang='zh' />

导航栏

添加分类页 / 标签页 / 归档页后，建议同时将其添加导航栏中

// .vitepress/config.ts
export default defineConfigWithTheme<ThemeConfig>({
  themeConfig: {
    nav: [
      { text: '分类', link: '/category' },
      { text: '标签', link: '/tags' },
      { text: '归档', link: '/archives' }
    ]
  }
}

插槽

Group 组件提供了 doc-after 和 doc-before 插槽，可以在页面顶部和底部插入自定义组件

---
title: 归档
layout: page
---

<Group type='category' lang='zh'>
  <template #doc-after>
    <MyComponents />
  </template>
</Group>


<script lang="ts" setup>
import MyComponents from '.vitepress/theme/components/MyComponents.vue';
</script>