#mdbook #summary #generate

app mdbook-generate-summary

A tool to automatically generate mdBook SUMMARY.md files

2 unstable releases

0.2.0 Jun 14, 2019
0.1.0 Mar 27, 2019

#31 in #summary

MIT license

14KB
266 lines

mdbook-generate-summary

This is a CLI tool to generate the SUMMARY.md page for an mdBook repository.

This is a tool I wrote because I'm abusing mdBook to act as a knowledge repository, and not as an actual book. I wanted to streamline the process of adding pages as much as possible, and not have to worry too much about maintaining that SUMMARY.md.

This does, however, make a few assumptions on the layout of your book:

Each subpage has an accompanying README.md.

E.G. Your book will always have the following directory tree under the src/:

foo.md
bar/README.md
bar/something_else.md
baz/README.md

That is, you'll never have a directory with a .md file in it, that doesn't ALSO have a README.md file.

If you do, the program won't detect that edge case, and it won't do the right thing.

Dependencies

~4MB
~71K SLoC