search

vuejs / vitepress

Vite & Vue powered static site generator.
https://vitepress.dev
MIT License
12.05k stars 1.96k forks source link

Multiple Sidebars auto produce/关于侧边栏的自动生成建议 #3704

Open recrute opened 3 months ago

recrute commented 3 months ago

Is your feature request related to a problem? Please describe.

  1. 我是从 gitbook，mdbook 过来的用户，这两个工具对侧边栏的目录数据，都是从文档的 SUMMARY.md 文件读取的。

  2. 最近发现了 vuepress，vitepress ，了解到这两个工具对侧边栏的目录数据是通过 themeConfig 枚举配置的，功能丰富实用强大。

Describe the solution you'd like

但是我们有时候并不希望完全在服务端控制这个书本的目录列表数据，希望可以提供多一个类似 gitbook，mdbook 的方式，可以让用户自己去编写 SUMMARY.md 文件更新侧边栏目录数据。

一者可以减少 config 文件的修改，二来也能提升各个书本自行对目录的把控。

recrute commented 3 months ago

提交 issue 前搜了一下第一眼没瞄到类似的 issue，刚再次找了一下，发现一个 https://github.com/vuejs/vitepress/issues/1297 类似的建议。

recrute commented 3 months ago

个人觉得理想的情况，应该是可以对每一本书都能指定自行控制一部分侧边栏的目录数据。 假如 vitepress 是一个出版社，那侧边栏指定的各个子目录就是每一本不一样的书本。

ykla commented 2 months ago

+1 希望兼容 gitbook 的 SUMMARY.md