vitepress-plugin-helper

一个 VitePress 插件，可以通过特定目录结构自动生成 nav 和 sidebar，并监听 MarkDown 文件更改自动重新生成菜单。通过 fast-glob 实现。

安装

1npm install vitepress-plugin-helper -D

用法

1import { DefaultTheme, defineConfig } from 'vitepress'
2import { vitePressHelperPlugin } from 'vitepress-plugin-helper'
3import { getNav, getSidebar } from './menu'
4
5
6export default defineConfig({
7  title: 'My Awesome Project',
8  description: 'A VitePress Site',
9  themeConfig: {
10    nav: getNav(),
11    
12    sidebar: getSidebar(),
13    
14    socialLinks: [
15      { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
16    ],
17  },
18  vite: {
19    plugins: [
20      vitePressHelperPlugin(),
21    ],
22  },
23})

工作原理

• 插件通过扫描 根目录 下的文件结构生成 nav 和 sidebar， nav 的生成依赖于子目录的 index.md(targetMDFile), sidebar 的生成可以不提供 index.md(targetMDFile)，但可以通过该文件自定义显示。

• .vitepress/cache/plugin_helper_trigger.md 是服务启动时是否需要生成菜单的判断依据，删除后可以触发生成菜单。

nav 辅助生成

可以在 MarkDown 文件中提供以下内容：修改标题（title）、排序（order）、是否有侧边栏（sidebar）、是否忽略（ignore）和分组（group）导航栏

1---

2title: Title
3order: 1
4ignore: false
5sidebar: true
6group: true
7---

sidebar 辅助生成

可以在 MarkDown 文件中提供以下内容：修改分组标题（title）、排序（order）、是否折叠（collapsed）和是否忽略（ignore）侧边栏

1---

2title: Title
3order: 1
4ignore: false // 高优先级
5// targetMDFile
6collapsed: false
7link: false
8---

查看示例：

• 配置在docs

• 配置在根目录

• 指定源目录