#mdbook #summary #gitbook

app book-summary

Create automatically a summary file for gitbook/mdbook

3 unstable releases

0.2.1 Oct 12, 2022
0.2.0 Oct 30, 2019
0.1.0 Oct 28, 2019

#1470 in Command line utilities

22 downloads per month

MIT license

28KB
588 lines

book-summary

book-summary-check build status book-summary-tests build status crates.io

Automatically creates a SUMMARY.md file for your book (mdbook/gitbook)

Similar to the npm version of the auto-summary tool gh/imfly/gitbook-summary, here is a rust version.

My initial intention is to get the chapters sorted without having to rename the chapter folders with a prefix number. The -s option takes the name of the chapters wich should come first. I use it in my personal notes repository: notes

Installation

OS X & Linux:

cargo install book-summary
git clone https://github.com/dvogt23/book-summary.git
cd book-summary
make install

Usage example

# create a SUMMARY.md file with custom sort in mdBook format
$ book-summary -n ./notes --sort tech personal
USAGE:
    book-summary [FLAGS] [OPTIONS]

FLAGS:
    -d, --debug        Activate debug mode
    -h, --help         Prints help information
    -m, --mdheader     Title from md file header?
    -V, --version      Prints version information
    -v, --verbose      Verbose mode (-v, -vv, -vvv)
    -y, --overwrite    Overwrite existing SUMMARY.md file

OPTIONS:
    -f, --format <format>            Format md/git book [default: md]
    -n, --notesdir <notesdir>        Notes dir where to parse all your notes from [default: ./]
    -o, --outputfile <outputfile>    Output file [default: SUMMARY.md]
    -s, --sort <sort>...             Start with following chapters
    -t, --title <title>              Title for summary [default: Summary]

Contributing

Feel free to open a pull request or an issue to contribute to this project.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Dependencies

~5–7MB
~122K SLoC