mirror of
https://github.com/NixOS/nix.git
synced 2025-11-08 19:46:02 +01:00
119 lines
2.7 KiB
Nix
119 lines
2.7 KiB
Nix
{
|
|
lib,
|
|
mkMesonDerivation,
|
|
|
|
meson,
|
|
ninja,
|
|
lowdown-unsandboxed,
|
|
mdbook,
|
|
mdbook-linkcheck,
|
|
jq,
|
|
python3,
|
|
rsync,
|
|
nix-cli,
|
|
changelog-d,
|
|
json-schema-for-humans,
|
|
officialRelease,
|
|
|
|
# Configuration Options
|
|
|
|
version,
|
|
|
|
# `tests` attribute
|
|
testers,
|
|
}:
|
|
|
|
let
|
|
inherit (lib) fileset;
|
|
in
|
|
|
|
mkMesonDerivation (finalAttrs: {
|
|
pname = "nix-manual";
|
|
inherit version;
|
|
|
|
workDir = ./.;
|
|
fileset =
|
|
fileset.difference
|
|
(fileset.unions [
|
|
../../.version
|
|
# For example JSON
|
|
../../src/libutil-tests/data/hash
|
|
../../src/libstore-tests/data/content-address
|
|
../../src/libstore-tests/data/store-path
|
|
../../src/libstore-tests/data/derived-path
|
|
../../src/libstore-tests/data/path-info
|
|
../../src/libstore-tests/data/nar-info
|
|
# Too many different types of files to filter for now
|
|
../../doc/manual
|
|
./.
|
|
])
|
|
# Do a blacklist instead
|
|
../../doc/manual/package.nix;
|
|
|
|
# TODO the man pages should probably be separate
|
|
outputs = [
|
|
"out"
|
|
"man"
|
|
];
|
|
|
|
# Hack for sake of the dev shell
|
|
passthru.externalNativeBuildInputs = [
|
|
meson
|
|
ninja
|
|
(lib.getBin lowdown-unsandboxed)
|
|
mdbook
|
|
mdbook-linkcheck
|
|
jq
|
|
python3
|
|
rsync
|
|
json-schema-for-humans
|
|
changelog-d
|
|
]
|
|
++ lib.optionals (!officialRelease) [
|
|
# When not an official release, we likely have changelog entries that have
|
|
# yet to be rendered.
|
|
# When released, these are rendered into a committed file to save a dependency.
|
|
changelog-d
|
|
];
|
|
|
|
nativeBuildInputs = finalAttrs.passthru.externalNativeBuildInputs ++ [
|
|
nix-cli
|
|
];
|
|
|
|
preConfigure = ''
|
|
chmod u+w ./.version
|
|
echo ${finalAttrs.version} > ./.version
|
|
'';
|
|
|
|
postInstall = ''
|
|
mkdir -p ''$out/nix-support
|
|
echo "doc manual ''$out/share/doc/nix/manual" >> ''$out/nix-support/hydra-build-products
|
|
'';
|
|
|
|
/**
|
|
The root of the HTML manual.
|
|
E.g. "${nix-manual.site}/index.html" exists.
|
|
*/
|
|
passthru.site = finalAttrs.finalPackage + "/share/doc/nix/manual";
|
|
|
|
passthru.tests = {
|
|
# https://nixos.org/manual/nixpkgs/stable/index.html#tester-lycheeLinkCheck
|
|
linkcheck = testers.lycheeLinkCheck {
|
|
inherit (finalAttrs.finalPackage) site;
|
|
extraConfig = {
|
|
exclude = [
|
|
# Exclude auto-generated JSON schema documentation which has
|
|
# auto-generated fragment IDs that don't match the link references
|
|
".*/protocols/json/.*\\.html"
|
|
# Exclude undocumented builtins
|
|
".*/language/builtins\\.html#builtins-addErrorContext"
|
|
".*/language/builtins\\.html#builtins-appendContext"
|
|
];
|
|
};
|
|
};
|
|
};
|
|
|
|
meta = {
|
|
platforms = lib.platforms.all;
|
|
};
|
|
})
|