分类 / 标签 / 归档

分类 / 标签

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

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

当有文章设置了分类或标签，主题会根据 outDir （默认为根目录）自动生成 category.md，分类与标签会在这个页面一起展示。

---
title: 分类
layout: page
---

<Category />

归档

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

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

<Archives />

导航栏

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

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

插槽

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

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

<Category>
  <template #doc-after>
    <MyComponents />
  </template>
</Category>


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