gitbook目录折叠

本文介绍了一款GitBook插件toggle-chapters,该插件能够帮助用户在面对大量章节时,实现目录的折叠和展开,使目录结构更加清晰,便于管理和阅读。通过在book.json中添加配置并安装插件,即可实现这一功能。
摘要由CSDN通过智能技术生成

背景

在编写gitbook的时候发现目录的数量比较庞大的时候显得杂乱无章,因为章节比较多的时候gitbook对于目录默认是全展开,很难有目的地寻找,对于管理人和阅读的读者来说很不友好。(主要是后者,一切都要从用户的角度考虑)

如果可以将gitbook的目录折叠,那么查找时会更加清晰,笔者在网上找到了插件,只要让gitbook引入即可。

插件

插件名称:toggle-chapters
效果:默认只在目录导航中显示章的标题,而不会显示小节的标题,点击每一章或者每一节会显示当前章或节的子目录,如果有的话,但是同时会收起其它之前展开的章节。
关于更多的gitbook插件,读者可以参考插件网站。

配置

在根目录(即与SUMMARY.md同级的目录)下的配置文件 book.json(如果没有则新建)中添加插件配置,如图:

在这里插入图片描述

配置完成后,可按照一下步骤进行:

$ cd gitbook根目录
$ npm install gitbook-plugin-toggle-chapters (此时gitbook的根目录下的node_modules文件夹中已经有了该插件了)
$ gitbook build
$ gitbook serve
访问 http://localhost:4000 看你的插件是否已经生效。

评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值