themeConfig

themeConfig 配置项作用于文章列表页、过渡动画等。

示例代码

• posts - 文章列表，由 usePosts 函数生成
• transition - 页面切换动画
• classicCategory - 是否启用旧版分类 / 标签
• page - 文章列表配置项
  • max - 分页器最大页数，超出后显示首页与尾页按钮，默认为 5
  • pinned - 置顶文章文本描述，默认为 [置顶]
  • outDir - 文章列表、分类/归档/标签页输出路径（需与 usePosts 方法中保持一致，用于分类与标签页路由）

.vitepress/config.ts

export default defineConfig<ThemeConfig>({
  themeConfig: {
    posts,
    transition: true,
    classicCategory: false,
    page: {
      max: 5,
      pinned: '[置顶]'
      outDir: ''
    }
  }
});

配置项

interface IPage {
  max?: number;
  pinned?: string;
  outDir?: string;
}

export interface ThemeConfig extends DefaultTheme.Config {
  posts?: IPost[];
  page?: IPage;
  transition?: boolean;
  classicCategory?: boolean;
}