07ef9f9f5d
mdbook already does include processing of its own, and the custom processing code has always admitted as much. we don't need it for the mdbook build at this point if we run our preprocessors in the right order, and maybe we can even have mdbook to return complete pages to us that we only have to pass to lowdown without any more preprocessing of our own. Change-Id: Icd978acbc3b1e215fee8f062c53ab2cb2a222ab1
31 lines
1 KiB
TOML
31 lines
1 KiB
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"]
|
|
before = ["anchors"]
|
|
|
|
[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"
|