gitbook 文章 TOC 目录


文章目录


1. page-treeview 插件

​page-treeview​​ 插件是生成页内目录

不需要插入标签,能支持到6级目录,安装可用

安装

npm i gitbook-plugin-simple-page-toc

​book.json​​配置:

{
"plugins": ["page-treeview"]
}

非必要配置:

"pluginsConfig": {
"page-treeview": {
"copyright": "Copyright © aleen42",
"minHeaderCount": "2",
"minHeaderDeep": "2"
}
}

这个插件生成目录以后,下面有一行关于版权的文字。如果想去掉的话,找到插件目录下的index.js文件:​​***/node_modules/gitbook-plugin-page-treeview/lib/index.js​​​ 找到如下这段代码
gitbook 插件 文章 TOC 目录_git

2. page-treeview-simple 插件

和 ​​page-treeview​​ 功能相同,在其基础之上修改了以下内容:

  • 去除​​copyRight​​ 的提示内容与占用的空白高
  • 取消章节的折叠效果,默认展开显示完整章节

效果图
gitbook 插件 文章 TOC 目录_gitbook_02

3. simple-page-toc 插件

​simple-page-toc​​ 插件生成本页目录 需要在文章中插入标签,支持1-3级目录 页面顶端生成。另外 GitBook 在处理重复的标题时有些问题,所以尽量不适用重复的标题。

安装

npm i gitbook-plugin-simple-page-toc

​book.json​​配置:

{
"plugins" : [
"simple-page-toc"
],
"pluginsConfig": {
"simple-page-toc": {
"maxDepth": 3,
"skipFirstH1": true
}
}
}

参数

说明

“maxDepth”: 3

使用深度最多为maxdepth的标题。

“skipFirstH1”: true

排除文件中的第一个h1级标题。

使用方法: 在需要生成目录的地方用下面的标签括起来,全文都生成的话就在首尾添加
gitbook 插件 文章 TOC 目录_github_03
效果图:
gitbook 插件 文章 TOC 目录_git_04

4. page-toc 插件

​page-toc​​​ 插件在你的 Gitbook 的每个页面上添加了一个目录 (TOC)。您可以设置目录是否默认显示在所有页面上,您可以启用或禁用个别页面上的目录以覆盖默认值。
安装

npm i gitbook-plugin-page-toc-af

​book.json​​配置:

{
"plugins": [ "page-toc" ],
"pluginsConfig": {
"page-toc": {
"selector": ".markdown-section h1, .markdown-section h2, .markdown-section h3, .markdown-section h4",
"position": "before-first",
"showByDefault": true
}
}
}

gitbook 插件 文章 TOC 目录_github_05