Skip to content

其他页配置

Teek 支持构建分类页、标签页、归档页,这些页面本质上是一个 Markdown 文档,通过在 frontmatter 配置来开启功能,因此可以与其他文档一起放到任意目录下。

但是 Teek 建议放在 @pages 目录下,因为 Teek 不会对 @pages 目录下的文档做任何处理(自动生成侧边栏、站点分析,自动生成 frontmatter 等)。

sh
.
├─ @pages
  ├── archivesPage.md
  ├── categoriesPage.md
  ├── tagsPage.md

分类页

frontmatter 中配置 categoriesPage: truelayout: home 来开启分类页。

yaml
---
title: 分类
categoriesPage: true
layout: home
permalink: /categories
article: false
---

permalink 需要配置为 /categories,如果你希望修改为 /c,需要在主题配置中配置 category.path/c

ts
import defineTeekConfig from "vitepress-theme-teek/config";

const teekConfig = defineTeekConfig({
  category: {
    path: "/c",
  },
});

标签页

frontmatter 中配置 tagsPage: truelayout: home 来开启标签页。

yaml
---
title: 标签
tagsPage: true
permalink: /tags
article: false
layout: home
---

permalink 需要配置为 /tags,如果你希望修改为 /t,需要在主题配置中配置 tag.path/t

ts
import defineTeekConfig from "vitepress-theme-teek/config";

const teekConfig = defineTeekConfig({
  tag: {
    path: "/t",
  },
});

归档页

有两种方式可以开启归档页:

  1. frontmatter 配置 archivesPage: truelayout: page 来开启归档页
  2. frontmatter 配置 layout: TkCataloguePage 来开启目录页
yaml
---
title: 归档
archivesPage: true
layout: page
permalink: /archives
article: false
sidebar: false
---
yaml
---
title: 归档
layout: TkCataloguePage
permalink: /archives
article: false
sidebar: false
---

permalink 没有强制要求为 /archives,你可以根据自己的需求进行配置,然后在导航栏配置 urlpermalink 的值即可。