kubernetes-handbook/node_modules/gitbook-plugin-page-toc-button/README.md

55 lines
1.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

# 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