A ready-to-use soupault setup for creating books, comparable to mdBook.
If you want to see a real book based on this blueprint, check out OCaml From the Ground Up.
You need soupault 5.0.0 or later to use this blueprint.
The sidebar with a list of chapters is generated completely automatically. There's no need to write a ToC/summary of the book by hand.
Chapter numbers are taken from file names. In the sample setup,
there are book/00_preface.md and book/01_sample_chapter.md.
Those numbers are also removed from output file paths,
so you will get clean /preface/ and /sample_chapter URLs instead.
The configuration file is soupault.toml.
You can set the title that appears in the HTML <title> by editing the [widgets.page-title]
section in the config.
The template for rendering the chapters index is in the widgets.chapters-index.index_template option.