We have a project that has a few mdBooks. Recently I was asked to build the project for newer OS versions, which meant building the books using a new mdBook version. One change that has occurred between last time I built the project and now is that mdBook used to ignore unknown keywords in book.toml, which was convenient for this particular use-case, because we used this to "tag" the books so that a web server could index the books by category and tags.

I could obviously just install an older mdBook, but I would prefer to not be stuck with ancient versions of software, so I'd rather find a way to allow us to update how we do the tagging such that we can use the latest version of mdBook.

What we need is very simple. In book.toml we'd add:

category = "adm"
tags = ["Administration", "Installation"]

Is there some way we can get mdBook to allow these? Either make it more lenient when parsing the configuration file, or is there some magical section that can be used for custom data? Or is there any other tips on how one would do this?

(The web server that scans the books and organizes them according to category/tags is a custom server that we control, so we can make any adjustments needed in it. With that said, it would be nice if the required changes were minimal).

1 post - 1 participant

Read full topic