VuePress|VuePress 侧边栏的具体使用
目录
- 前言
- 目录结构:
- 最简侧边栏:
- 侧边栏分组
- 显示文件名(或其他指定名字)
- 方法1
- 方法2
前言 官网写的侧边栏教程真的是让人很糟心,经过一番摸索,总算大致弄清楚了,下面详细说一下用法:
目录结构:
文章图片
docs根目录下有一个README.md、chinese文件夹、english文件夹
最简侧边栏:
sidebar: {'/language/chinese/': ['',//该目录下的README.md文件'a', //该目录下的a.md文件'b'//该目录下的a.md文件], '/language/english/': ['',],},
chinese文件夹下的侧边栏:
文章图片
english文件夹下的侧边栏:
文章图片
可以看到,侧边栏效果出来了,但是我们看官网上的效果:
文章图片
侧边栏上边有分组,图上的侧边栏分成了两组,这里就是侧边栏分组了
侧边栏分组 我们把chinese文件夹下的README.md分到Group1,a.md、b.md分到Group2:
sidebar: {'/language/chinese/': [{title: 'Group1',//组名children: [''],//该分组下要显示的文件的目录},{title: 'Group2',children: ['a','b'],},],'/language/english/': ['',],},
文章图片
文章图片
可以看到分组成功,可以发现,每个md直接显示了它的一二级标题,如果我们想除了显示文件中的一二级标题,还显示这篇md文件的文件名(或指定的其他名字),比如下面这种效果:
文章图片
该怎么做呢?官方给了这样一个例子,用一个数组来指定路径和名字:
文章图片
我们尝试一下:
sidebar: { '/language/chinese/': [{title: 'Group1',//组名children: [['', 'chinese']]},{title: 'Group2',children: [['a', 'A'],['b', 'B'],],}]}
结果却是:
文章图片
文章图片
可以看到它只是改了一级标题的名字,并没有额外增加一个名字,还有其他方法吗方法肯定是有的。
显示文件名(或其他指定名字)
方法1
最简单的做法就是md文件中,把一级标题的名字改为我们指定的名字,这样做的坏处就是一级标题只能在这个md文件中使用一次,(推荐使用该方法)
文章图片
可以看到再一个一级标题没有出现在侧边栏中
方法2
给这个文件添加分组,添加一个分组名,即一个md文件就是一个分组,然后再用大分组,把这些小分组括起来。
小分组
我们给README.md添加名为chinese的分组:
{title: 'chinese',children: [‘'],},
给a.md添加名为A的分组
{title: 'A',children: [‘a'],},
给b.md添加名为B的分组
{title: 'B',children: [‘b'],},
大分组:
把chinese假入大组Group1:
{title: 'Group1',children: [{title: 'chinese',children: [''],},],},
把A、B加入大组Group2:
{title: 'Group2',children: [//小组A{title: 'A',children: ['a'],},//小组B{title: 'B',children: ['b'],}, ],},
完全代码:
sidebar: { '/language/chinese/': [//Group1{title: 'Group1',children: [{title: 'chinese',// 必要的children: ['']}]},//Group2{title: 'Group2',children: [//小组A{title: 'A',children: ['a'],},//小组B{title: 'B',children: ['b'],},],}, ], },
文章图片
文章图片
显然,这样写起来眼花缭乱,因此推荐方法一。
【VuePress|VuePress 侧边栏的具体使用】到此这篇关于VuePress 侧边栏的具体使用的文章就介绍到这了,更多相关VuePress 侧边栏内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
推荐阅读
- vue移动端时弹出侧边抽屉菜单效果
- 专栏开篇(我为什么要写这篇专栏())
- #yyds干货盘点# js学习笔记四十六实现两栏布局的第二种方式
- 【小程序专栏】个人及企业资质分别该如何注册小程序
- css|CSS两栏布局的实现和水平垂直居中的实现
- WIN8系统任务栏中添加计算机的办法
- win7系统之家教你如何处理Win7 任务栏无法添加、锁定程序的问题
- 系统之家win7纯净版64位系统任务栏网络图标显示异常的处理办法
- Win10系统任务栏假死怎样处理
- Win10系统如何让Cortana搜索栏显示你爱听的话