1.0.13 • Published 2 years ago

vuepress-plugin-auto-navbar v1.0.13

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

vuepress-plugin-auto-navbar

vuepress导航栏自动生成

效果预览

Feature

  • 支持功能
    • 自动生成navbar配置
    • TypeScript支持
    • 目录/文件前缀设置,默认为「 📂 」/「 ✏️ 」
    • 目录/文件的过滤
    • 读取深度设置
    • 兼容vuepress和vuepress@next
  • 下一步优化
    • 插件配置待丰富
    • 过滤支持正则

Usage

  1. 安装插件
pnpm i vuepress-plugin-auto-navbar
  1. vuepress配置中使用插件,示例如下
import AutoNavPlugin from 'vuepress-plugin-auto-navbar'

module.exports = {
  themeConfig: {
    navbar: AutoNavPlugin({
      subNavShow: ['其他', '工具使用', 'Vue', '设计模式', '前端工程化', '计算机网络', '算法基础', '刷题技巧'], // 要显示子目录的目录
      ignoreFolders: ["node_modules", "assets", "public", ".vuepress", "code", ".obsidian", "utils"], // 需要排除的一些目录
      ignoreFiles: ['个人简历'], // 需要排除的一些文件
      dirPrefix: '目录:',
      filePrefix: '文件:',
      useREADME: false, // 是否以README文件作为目录跳转后的展示内容,请确保该目录下包含README文件,否则默认使用「 第一个文件夹下的README文件 」或「 第一个文件 」作为展示内容
      depth:2, // 读取目录的深度
      childrenKey:'items' // 指定子nav的字段
    })
};

Options

属性类型默认值描述
subNavShowString[][]要显示子目录的目录
ignoreFoldersString[][]需要排除的一些目录
ignoreFilesString[][]需要排除的一些文件
dirPrefixString📂目录前缀修饰,有助于区分
filePrefixString✏️文件前缀修饰,有助于区分
useREADMEBooleanfalse是否以README文件作为目录跳转后的展示内容,请确保该目录下包含README文件,否则默认使用「 第一个文件夹下的README文件 」或「 第一个文件 」作为展示内容
depthNumber2读取目录的深度
childrenKey'items' | 'children''items'兼容vuepress和vuepress@next
1.0.13

2 years ago

1.0.12

2 years ago

1.0.11

2 years ago

1.0.10

2 years ago

1.0.9

2 years ago

1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago