gitbook-plugin-isummary

Gitbook plugin to auto-generate SUMMARY.md with ignore path

copy by gitbook-plugin-summary

Introduction

This plugin was created out of the frustration of not having a way to auto-generate a SUMMARY.md file, out of a basic tree structure. The outcome is that you install this plugin and it just works, on top of your current book.json file. No custom configurations required.

Installation

First you need to install the package using

$ npm i gitbook-plugin-isummary --save

afterwards, you need to add to your book.json the plugin, like this

{
  "plugins": [
    "isummary"
  ],
  "pluginsConfig": {
    "isummary": {
      "ignorePath": ["assets"]
    }
  }
}

and finally run the command

$ gitbook serve

Rules

Names

• README.md: Taken from their directory name
• File: Taken from the first first-header (ex: # title) of the file
• Directory: Name of the directory

Entry Types

Directory at the root of the gitbook

• With a README first level in it, it will be shown as a normal link
• If it doesn't, it will be shown as a section

Nested Directories

• With a README first level in it, it will be shown as a normal link
• If it doesn't, it will be shown as a label (or disabled link, if you will)

Files

• Only markdown files are shown

Example

Let's assume that your source tree is done like this way:

$ tree .
.
├── 1-Getting Started
│   ├── 0-README.md
│   └── 1-TEST.md
├── 2-Reference
│   └── 0-README.md
├── README.md
└── SUMMARY.md

your SUMMARY.md file will look like this:

- [Getting Started](1-Getting Started/0-README.md)
    - [Test](1-Getting Started/1-TEST.md)
- [Reference](2-Reference/0-README.md)

and this is how it will be shown inside your Gitbook:

License

See LICENSE