eldritch horrors
6a5f100b8b
mdbook has the unfortunate habit of creating stub files for chapters it
can't find on disk. turn off this helpful feature as it masks errors in
the summary file, and fix a recently introduced instance of this error.
Change-Id: I10d86aac0489c9c494bd5c8a50047415f4d4b18d
37 lines
1.3 KiB
TOML
37 lines
1.3 KiB
TOML
[book]
|
|
title = "Nix Reference Manual"
|
|
|
|
[build]
|
|
create-missing = false
|
|
|
|
[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,
|
|
# {{#include handlebars}}, and the @generated@ syntax used within these. it mostly
|
|
# but not entirely replaces the links preprocessor (which we cannot simply use due
|
|
# to @generated@ files living in a different directory to make meson happy). we do
|
|
# not want to disable the links preprocessor entirely though because that requires
|
|
# disabling *all* built-in preprocessors and selectively reenabling those we want.
|
|
[preprocessor.substitute]
|
|
command = "python3 doc/manual/substitute.py"
|
|
before = ["anchors", "links"]
|
|
|
|
[preprocessor.anchors]
|
|
renderers = ["html"]
|
|
command = "jq --from-file doc/manual/anchors.jq"
|
|
|
|
[output.markdown]
|
|
|
|
[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"
|