A CLI to generate a summary from a given folder.

Downloads in past


176201.2.42 years ago9 years agoMinified + gzip package size for gitbook-summary in KB


Gitbook Summary
npm version Build Status Dependencies Status Coverage Status
A command line tool to generate a SUMMARY.MD from a folder。Demo 中文文档


  • 《Nodejs区块链开发2》:
  • 《Nodejs区块链开发》:
  • 《用Gitbook和Github轻松搭建自出版平台》:
  • 《sails.js 官方文档 多语言电子书》:

More Gitbooks :


  • Generate by using a CLI with some options
  • Setting with book.json
  • Link to the parent directory
  • Only get '.md' files
  • Order by alphabet or numbers
  • ...

CoC (Convention over Configuration)

Source directory:
├── 1-FirstChapter   // The first chapter,format: {orderNumber or alphabet}-{chapterName}.md
├──────  // concentrating solely on the order, not the numbers.
├── 3-SecondChapter                     // Focus only on the order, not the numbers.
├── 7-ThirdChapter
├── FourthChapter  // May have no order
├── // In addition to, not to put other markdown documents
└── book.json     // Set up the book


npm install -g gitbook-summary


1> Generate a Simply
$ cd /path/to/your/book/
$ book sm

or, For example:
$ book sm -r ../sailsjs-docs-gitbook/en -i 0home -u 'myApp' -c 'concepts, reference, userguides' -n "Sails.js 官方文档(中英合辑)"

To see the command line options:
$ book sm --help

  Usage: summary|sm [options]

  Generate a `` from a folder


    -h, --help                    output usage information
    -r, --root [string]           root folder, default is `.`
    -t, --title [string]          book title, default is `Your Book Title`.
    -c, --catalog [list]          catalog folders included book files, default is `all`.
    -i, --ignores [list]          ignore folders that be excluded, default is `[]`.
    -u, --unchanged [list]        unchanged catalog like `request.js`, default is `[]`.
    -o, --outputfile [string]     output file, defaut is `./`
    -s, --sortedBy [string]       sorted by sortedBy, for example: `num-`, defaut is sorted by characters
    -d, --disableTitleFormatting  don't convert filename/folder name to start case (for example: `JavaScript` to `Java Script`), default is `false`

  • The article title is taken from title property in the articles front-matter. If this property is not available, the articles filename will be used as title for the summary.
  • The option -s or --sortedBy can not be given - as argument, because commander.js will parse it an option. But you can set it in book.json as follows.
    set up the sortedBy and if there are any summaries missing the order, look at the example below and follow,
for example, you have summaries like this 01-elementry-school, 02-middle-school, 03-university, ...
you realized high school was missing, then You can make correct order in the following way
eg. 01-elementry-school, 02-middle-school, 02a-high-school, 03-university, ...
not 01-elementry-school, 02-middle-school, 03-high-school, 04-university, ...
2> Create a book.json in the book`s root folder
for example:
// test/books/config-json/book.json
    "title": "json-config-name",
    "outputfile": "",
    "catalog": "all",  // or [chapter1,chapter2, ...]
    "ignores": [],  //Default: '.*', '_book'...
    "unchanged": [], // for example: ['myApp'] -> `myApp` not `My App`
    "sortedBy": "-",
    "disableTitleFormatting": true // default: false

then, you can do:
$ book sm

You will get a file:
3> Get a markdown artical from a html file or a remote url
$ book md -l "" -s "div.className"

You will get the 'index.html' and ''.
4> Get convert between zh and zh-tw, zh-hk, or zh-sg
$ book cv -f ./test/language/ -l zh-tw -t "./test/language/"


npm install
npm link


npm test


  • Convert articals between Simplified and Traditional Chinese.
  • Generate eBooks(html, pdf, etc) by extending gitbook;


We love pull requests! You can fork it and commit a pr


The MIT License