本页导航
article
自动生成侧边栏
AI摘要
本文介绍了vitepress-plugin-sidebar-depth插件的功能、安装使用方法及详细配置选项。该插件能自动扫描项目中的markdown文件,生成结构清晰的侧边栏,支持多语言和文件排序,且提供丰富的配置和钩子函数,方便用户根据需求定制侧边栏表现。使用该插件可以提升vitepress文档站点的维护效率和用户体验。
vitepress-plugin-sidebar-depth使用
github地址
特性
- 🚀 扫描项目的目录,自动生成侧边栏数据,挂载到
themeConfig.sidebar - 🚀 支持自定义扫描的递归深度
- 🚀 支持
01.guide.md带有序号的文件格式,在渲染侧边栏数据时,带序号的文件位置比不带序号的文件高 - 🚀 支持 locales 国际化,挂载到
locales.[lang].themeConfig.sidebar
说明:在同层目录下,如果存在相同序号的文件时,后面的文件会覆盖前面的文件
侧边栏的 text 获取顺序:
- 如果为目录:按顺序从该目录下的
index.md, index.MD, 目录名.md文件获取一级标题,如果获取不到,则以目录名为text - 如果为文件:
formatter.title> Markdown 文件一级标题(titleFormMd为 true 生效) > Markdown 文件名
安装
安装 vitepress-plugin-sidebar-depth 插件
加载中...
最后更新于 2025-10-29 11:25