lix/doc/manual/src
eldritch horrors 725f5cd358 docs: redo content generation for mdbook and manual
manpages can be rendered using the markdown output of mdbook, the rest
of the manual can generated out of the main doc/manual source tree. we
still use lowdown to actually render manpages instead of eg mdbook-man
because lowdown does generate reasonably good manpages (though that is
also somewhat debatable, but they're a lot better than mdbook-man).

doing this not only lets us drastically simplify the lowdown pipeline,
but also remove all custom {{#include}} handling since now mdbook does
all of it, even for the manpage builds. even the lowdown wrapper isn't
entirely necessary because lowdown can take all wrapper arguments with
command line flags rather than bits of input file content.

This also implements running mdbook in Meson, in order to generate the
manpages. The mdbook outputs are also installed in the usual location.

Co-authored-by: Qyriad <qyriad@qyriad.me>

Change-Id: I60193f9fd0f15d48872f071af35855cda2a0f40b
2024-04-11 13:32:06 +00:00
..
advanced-topics Add pre-commit checks 2024-03-29 22:57:40 -07:00
architecture Add pre-commit checks 2024-03-29 22:57:40 -07:00
command-ref docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
contributing docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
figures Move figures 2020-07-24 12:58:31 +02:00
installation Add pre-commit checks 2024-03-29 22:57:40 -07:00
language docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
package-management Add pre-commit checks 2024-03-29 22:57:40 -07:00
protocols Allow dynamic derivation deps in inputDrvs 2023-09-07 10:39:37 -04:00
release-notes docs: redo content generation for mdbook and manual 2024-04-11 13:32:06 +00:00
_redirects Add pre-commit checks 2024-03-29 22:57:40 -07:00
glossary.md disambiguate output from output path 2023-09-06 09:09:02 +02:00
introduction.md Convert short nix options to long ones 2023-05-17 08:10:30 +01:00
quick-start.md Update doc/manual/src/quick-start.md 2023-02-19 20:00:02 -05:00
SUMMARY.md docs: don't compute SUMMARY.md during build 2024-04-09 02:09:36 +00:00