[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"