55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Gitbook Page TOC Button Plugin [![npm version](https://badge.fury.io/js/gitbook-plugin-page-toc-button.svg)](https://badge.fury.io/js/gitbook-plugin-page-toc-button)
|
||
|
||
This plugin adds a table of content (TOC) button to your GitBook page. All three GitBook themes (White, Sepia, Night) are supported. This project took heavy inspiration from https://plugins.gitbook.com/plugin/anchor-navigation.
|
||
|
||
## Usage
|
||
|
||
### Installation
|
||
|
||
Add the plugin to your `book.json`:
|
||
|
||
```
|
||
{
|
||
"plugins" : [ "page-toc-button" ]
|
||
}
|
||
```
|
||
|
||
### Optional configuration
|
||
|
||
You can add the following configuration params to your `book.json`:
|
||
|
||
```
|
||
{
|
||
"plugins" : [
|
||
"page-toc-button"
|
||
],
|
||
"pluginsConfig": {
|
||
"page-toc-button": {
|
||
"maxTocDepth": 2,
|
||
"minTocSize": 2
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Name | Type | Default | Description
|
||
----------- | ------- | ------- | ------------
|
||
maxTocDepth | Number | 2 | Maximal depth of headers (2 = h1 + h2 + h3). A value > 2 is not supported.
|
||
minTocSize | Number | 2 | Minimal number of toc entries for showing the toc button.
|
||
|
||
## Screenshots
|
||
|
||
The page toc button:
|
||
|
||
![Page Toc Button](https://raw.githubusercontent.com/stuebersystems/gitbook-plugin-page-toc-button/master/screenshot1.png)
|
||
|
||
The page toc menu:
|
||
|
||
![Page Toc Menu](https://raw.githubusercontent.com/stuebersystems/gitbook-plugin-page-toc-button/master/screenshot2.png)
|
||
|
||
## Changelog
|
||
|
||
* 0.1.0 Releases:
|
||
* 0.1.0 First release
|
||
* 0.1.1 Button icon switched
|