eldritch horrors
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
32 lines
1 KiB
TOML
32 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"
|