ANSSI-FR / mdbook-checklist

mdbook preprocessor for generating checklists and indexes
Other
13 stars 1 forks source link

mdBook checklist preprocessor

Crates.io Github CI Github CI

A preprocessor for gathering checks in an mdBook and generating an index.

Usage

First, you need to install the preprocessor:

cargo install mdbook-checklist

Next, you need to add the preprocessor to your book.toml:

[book]
authors = ["Me"]
multilingual = false
src = "src"
title = "The Book"

[preprocessor.checklist]

Finally, you can insert marks in your book chapters, according to the following format: {{#check <name> | <description>}}. For example

# Chapter 1

{{#check Note-1 | This is an important note}}

The mark will be replaced by the name solely (with an anchor to be linked from the index). Also, for this example, the following index will be generated:

Checklist

  • Chapter 1:
    • [ ] This is an important note (Note-1)

Options

The title Checklist of the generated index can be changed:

[preprocessor.checklist]
title = "A list of notes"

Licence

This library is published under the Open Licence 2.0.