gitbook-plugin-gtoc v0.2.0

GitBook Table Of Content Plugin

为GitBook生成目录结构，效果如下：

使用方式

在book.json中添加如下配置： { "plugins": "gtoc" }

然后运行gitbook install即可。

功能

• 抽取页面标题组成目录列表
• 自动添加序号
• 可隐藏GTOC
• 回到顶部功能，可配置是否有“电梯”效果
• 适配Gitbook的“Sepia”、“Night”主题
• 抽离出配置项，提供

快捷键

【t】:收缩/展现目录

【h】:显示/隐藏目录

说明

• 默认只抽取h2,h3标题
• 默认进入页面就显示（后期会修改默认隐藏）

TODO

• 需要有本地存储功能，记忆上次用户阅读的位置，可配置此功能【2014.12.23】
• 需要抽取出配置项【2014.12.23】
• 适应不同主题下的样式（比如夜间模式等等）【20141219】
• 添加滚动高显功能，电梯功能【20141219】
• 功能的模块化【20141219】
• 绑定快捷键't'，用于toggle显示/隐藏【20141218】
• 手柄hover状态时，需显示提示文字【20141218】
• 添加“回到顶部”【20141218】
• 配置：【20141218】
  • 抽取层级
  • 放在左边还是右边
  • 跟随还是放在开头（跟随的时候可以折叠，包含“回到顶部”按钮）

修改记录

2015.01.04

• 修复“初始化组件，内容太长也不会显示滚动条”的bug

2014.12.24

• 完成电梯功能
• 解决ScrollTop的奇怪问题，“只有在Chrome打开控制台情况下'回到顶部'按钮才有有效”，这是因为当宽度大于1240时body-inner是固定高度的，而当宽度小于1240时，body-inner是变高度，book-body是固定高度的；原始代码只对book-body设置scrollTop动画，所以打开Chrome窗口的时候（意外地使得浏览器窗口小于1240）才有动画；已经修复。

2014.12.22

• 主题模式的匹配
• "回到顶部"功能

2014.12.19

• 重构，模块化，抽离出content模块，专注目录dom字符串
• 调整目录结构，使得能够出现垂直滚动条
• 添加state-scroll，只有当窗口高度小于目录高度时候才显示滚动条

2014.12.18

• 使用$.guid给不同的标题赋Id
• 使用tagName给不同层级标题赋值类名
• 添加动画效果