vite-plugin-vitepress-auto-nav

中文文档

Auto-generate VitePress nav and sidebar configurations.

✨ Features

• Use primary folder as nav and secondary folder and files as sidebar
• Automatic refresh after changing plugin configuration or frontmatter.
• Support for customizing read ranges (based on srcDir and srcExclude configurations).
• Support to customize whether the index.md under the sub-folder is displayed separately or by clicking the folder name.
• Support for customizing the display name, articles also support the first level of the title as the name.
• Support for customizing the sorting method
• Support for customizing hidden files or folders
• Supports both plugin options and article frontmatter configurations to customize article configurations (configured attribute names also support adding prefixes).
• Support for using the same Gitbook SUMMARY.md file as the sidebar configuration.

🕯️ Usage

1. Install

1# Installing vite is recommended when using ts, otherwise you will get type errors.
2pnpm i vite-plugin-vitepress-auto-nav vite -D

2. Add the plugin

1// .vitepress/config.ts
2import AutoNav from “vite-plugin-vitepress-auto-nav”;
3
4export default defineConfig({
5  vite: {
6    plugins: [
7      AutoNav({
8        // Custom configurations
9      })
10    ]
11  }
12});

3. Start the project normally and it's ready to use

Configuration

Please refer to the TypeScript type hints

License

MIT License © 2023 Xaviw