0.0.2 • Published 7 years ago
gitbook-plugin-etoc-plus v0.0.2
gitbook-plugin-etoc-plus
This plugin will add table of content (toc) to the page automatically.
When you build the book, it will insert a table of content automatically or to place where you insert <!-- toc -->
. Sometimes you may want to disable toc on some page, just add <!-- notoc -->
on the the markdown page.
Features
- Supported custom anchors in headings. Example: ### TitleH3 {#title-example}
- Option «Auto translit» for anchors in headings (cyrrillic to latin)
- Work good with dark and light default gitbook themes.
Example
# Heading 1
<!-- toc -->
## Heading 2.1
Some text
## Heading 2.2 {#any-anchor-name}
Some text
Sample
Config
Add etoc-plus
in book.json
is enough for most users.
{
"plugin": ["etoc-plus"]
}
It will add toc automatically if the markdown page has ###
header3 (mindepth required to generate toc), and the maxdepth of toc is ####
header4 by default. You can also change the default parameter such as:
{
"plugins": [
"etoc-plus"
],
"pluginsConfig": {
"etoc-plus": {
"mindepth": 3,
"maxdepth": 4,
"notoc": false,
"header": 1,
"translit": false
}
}
}
The configuration json schema is shown as following:
"gitbook": {
"properties": {
"mindepth": {
"type": "number",
"description": "minimal heading level required to generate toc",
"default": 3
},
"maxdepth": {
"type": "number",
"description": "maximal heading level to generate toc",
"default": 4
},
"notoc": {
"type": "boolean",
"description": "whether to generate toc automatically",
"default": false
},
"header": {
"type": "number",
"description": "insert TOC after header",
"default": 1
},
"translit": {
"type": "boolean",
"description": "auto translit cyrillic #anchors in headings to latin",
"default": false
},
}
}
LICENSE
MIT