c355354772
We're not entirely clear on why the links preprocessor has to be done *before* rather than after, but we assume it is probably that as a builtin preprocessor it does some processing on the raw book source, and not just the JSON data. Also a real use for Python pattern matching? I know I was surprised too. Change-Id: Ibe8b59e7b5bd5f357a655d8b4c5f0b0f58a67d6b
30 lines
1,023 B
TOML
30 lines
1,023 B
TOML
[book]
|
|
title = "Nix Reference Manual"
|
|
|
|
[output.html]
|
|
additional-css = ["custom.css"]
|
|
additional-js = ["redirects.js"]
|
|
edit-url-template = "https://github.com/NixOS/nix/tree/master/doc/manual/{path}"
|
|
git-repository-url = "https://github.com/NixOS/nix"
|
|
|
|
# Handles replacing @docroot@ with a path to ./src relative to that markdown file.
|
|
[preprocessor.docroot]
|
|
renderers = ["html", "linkcheck"]
|
|
command = "python3 doc/manual/docroot.py"
|
|
# I would have thought that @docroot@ replacement had to be done *before*
|
|
# the link preprocessor gets its hands on this book, but nope it's actually
|
|
# the opposite.
|
|
after = ["links"]
|
|
|
|
[preprocessor.anchors]
|
|
renderers = ["html"]
|
|
command = "jq --from-file doc/manual/anchors.jq"
|
|
|
|
[output.linkcheck]
|
|
# no Internet during the build (in the sandbox)
|
|
follow-web-links = false
|
|
|
|
# mdbook-linkcheck does not understand [foo]{#bar} style links, resulting in
|
|
# excessive "Potential incomplete link" warnings. No other kind of warning was
|
|
# produced at the time of writing.
|
|
warning-policy = "ignore"
|