vitepress-auto-nav-sidebar

vitepress导航栏自动生成

效果预览

Feature

• 支持功能
  • 自动生成nav和sidebar配置
  • TypeScript支持
  • 目录/文件前缀设置，默认为「 📂 」/「 ✏️ 」
  • 目录/文件的过滤
• 下一步优化
  • 插件配置待丰富
  • 过滤支持正则

Usage

1. 安装插件

1pnpm i vitepress-auto-nav-sidebar

2. 在vuepress配置中使用插件，示例如下

1import AutoNavPlugin from 'vitepress-auto-nav-sidebar'
2
3const { nav, sidebar } = AutoNavPlugin({
4  ignoreFolders: ["node_modules", "assets", "public", ".vuepress", "code", ".obsidian", "utils"], // 需要排除的一些目录
5  ignoreFiles: ['个人简历'], // 需要排除的一些文件
6  dirPrefix: '目录：',
7  filePrefix: '文件：',
8  showNavIcon:false,
9  showSideIcon:true,
10  isCollapse: true,
11  collapsed: true,
12  singleLayerNav:true,
13  hiddenFilePrefix: '.'
14})
15module.exports = {
16  themeConfig: {
17    nav,
18    sidebar,
19  },
20};

Options

属性	类型	默认值	描述
entry	String	'docs'	设置相对于项目根目录的检索入口
singleLayerNav	Boolean	false	是否设置单层nav
showSideIcon	Boolean	false	显示sidebar修饰
showNavIcon	Boolean	true	显示nav修饰
isCollapsible	Boolean	true	sidebar是否可折叠
ignoreFolders	String[]	[]	需要排除的一些目录
ignoreFiles	String[]	[]	需要排除的一些文件
filePrefix	String	✏️	文件前缀修饰，有助于区分
dirPrefix	String	📂	目录前缀修饰，有助于区分
collapsed	Boolean	false	sidebar默认不折叠
customParentFolderName	String	''	自定义侧边栏父文件夹的显示文本，不设置或为空还是默认显示原父文件夹名
hiddenFilePrefix	String	'.'	设置隐藏文件的前缀