VitePress 极简主题：主页配置

文章列表提供了两种模式，一种是直接将文章列表作为主页，生成的第一页命名为 index.md；第二种是自定义主页，第一页命名为 page-1.md，这样你就可以创建自己的 index.md 了~

两者可以通过 usePosts 方法的 index 参数来切换，配置为 false 后，第一页会被命名为 page-1.md。

提示

除了根目录外，每个文章目录都可以创建自己的 index.md

.vitepress/config.ts

const { posts, hiddenPosts, excludePosts, descriptionMap, rewrites } = await usePosts({
  folder: [
    { input: 'posts', index: false },
    'essays'
  ]
});

自定义主页

警告

切换模式时，手动创建的 index.md 会被文章列表覆盖！

当 index参数设置为 false 时，生成的文章列表以 page-1.md 开始，因此你可以创建自己的 index.md 作为主页。

主题内置了一个 <Home /> 组件（样式参考演示站），你可以按照以下方式创建：

• imgUrl: 主页图片
• title: 主页标题
• desc: 主页描述
• links: 对象数组，url 为链接，text 为按钮文字

index.md

---
layout: page
---

<Home imgUrl="/profile.png" title="只抄" desc="Less is more." :links="[{ url: 'https://github.com/izhichao/vitepress-theme-minimalism', text: 'Github ->' }]" />

使用自定义主页时，建议将文章列表单独添加到 nav 中，参考以下配置：

.vitepress/config.ts

export default defineConfigWithTheme<ThemeConfig>({
  themeConfig: {
    nav: [
      { text: 'Home', link: '/' },
      { text: 'Posts', link: '/page-1' }
    ]
  }
}

文章列表

当参数设置为 true 时（默认为 true，可以省略），从 posts 文件夹中生成的文章列表将命名为 index.md page-2.md page-3.md ……

此时的 nav 配置如下：

.vitepress/config.ts

export default defineConfigWithTheme<ThemeConfig>({
  themeConfig: {
    nav: [
      { text: 'Home', link: '/' }
    ]
  }
}