侧边栏
2025/11/11大约 1 分钟
侧边栏
自动生成
实现:
import { sidebar } from "vuepress-theme-hope";
export default sidebar({
"/": "structure",
// sidebar: "structure",
});或在 theme.ts 中配置
通过指定值为structure 来自动生成侧边栏
效果:
默认按照文件名进行排序
通过自动生成侧边栏的缺点:会显示根目录下所有的目录。
如果只想显示当前文件所在目录下的所有文件列表,可以:
import { sidebar } from "vuepress-theme-hope";
export default sidebar({
"/": "structure",
"/English" : "structure",
});效果:
问:怎么让所有的目录都按照当前目录 自动生成只包含当前路径下文件的侧边栏?
手动配置
实现:
export default hopeTheme({
sidebar: [
{
text: "英语",
icon: "fa6-solid:wrench",
link: "/English/",
children: [
"/English/Articles.md",
"/English/Determiners.md",
],
}
],
});| 行号 | 功能 | 说明 |
|---|---|---|
| 5 | 分栏标题 | |
| 7 | 点击标题跳转的链接 | 指定文件完整名称,如果只有Atricles 则链接到的文件是Atricles.html |
| 8-11 | 分栏下的链接 | 绝对路径 |
效果:
使用相对路径
可以设置prefix,然后分栏内的链接就可以使用相对prefix的路径
实现:
sidebar: [
{
text: "英语",
icon: "fa6-solid:wrench",
link: "/English/",
prefix: "/English/",
children: [
"Articles.md",
"Determiners.md",
],
}
],嵌套
多级分层
实现:
sidebar: [
{
text: "英语",
icon: "fa6-solid:wrench",
link: "/English/",
prefix: "/English/",
children: [
"Articles.md",
"Determiners.md",
{
text: "6 - Pronouns",
prefix: "/English/",
children: [
"Personal Pron..md",
],
},
],
}
],| 行号 | 功能 | 说明 |
|---|---|---|
| 11 | 如果标题没有链接,那么就按照text显示。指定链接按照链接文章标题显示 |
效果: