mirror of
https://github.com/nix-community/home-manager
synced 2024-09-21 05:47:29 +02:00
This update fixes the custom CSS to make the `$` character non-selectable in highlighted code blocks.
160 lines
5.4 KiB
Nix
160 lines
5.4 KiB
Nix
{ pkgs
|
|
|
|
# Note, this should be "the standard library" + HM extensions.
|
|
, lib ? import ../modules/lib/stdlib-extended.nix pkgs.lib
|
|
|
|
, release, isReleaseBranch }:
|
|
|
|
let
|
|
|
|
nmdSrc = fetchTarball {
|
|
url =
|
|
"https://git.sr.ht/~rycee/nmd/archive/f18defadcc25e69e95b04493ee02682005472255.tar.gz";
|
|
sha256 = "14fazjqbc6sfsxycwadfhcymi37xg5wmrlvg3jb8d4mpbcdwfwz4";
|
|
};
|
|
|
|
nmd = import nmdSrc {
|
|
inherit lib;
|
|
# The DocBook output of `nixos-render-docs` doesn't have the change
|
|
# `nmd` uses to work around the broken stylesheets in
|
|
# `docbook-xsl-ns`, so we restore the patched version here.
|
|
pkgs = pkgs // {
|
|
docbook-xsl-ns =
|
|
pkgs.docbook-xsl-ns.override { withManOptDedupPatch = true; };
|
|
};
|
|
};
|
|
|
|
# Make sure the used package is scrubbed to avoid actually
|
|
# instantiating derivations.
|
|
scrubbedPkgsModule = {
|
|
imports = [{
|
|
_module.args = {
|
|
pkgs = lib.mkForce (nmd.scrubDerivations "pkgs" pkgs);
|
|
pkgs_i686 = lib.mkForce { };
|
|
};
|
|
}];
|
|
};
|
|
|
|
dontCheckDefinitions = { _module.check = false; };
|
|
|
|
gitHubDeclaration = user: repo: subpath:
|
|
let urlRef = if isReleaseBranch then "release-${release}" else "master";
|
|
in {
|
|
url = "https://github.com/${user}/${repo}/blob/${urlRef}/${subpath}";
|
|
name = "<${repo}/${subpath}>";
|
|
};
|
|
|
|
hmPath = toString ./..;
|
|
|
|
buildOptionsDocs = args@{ modules, includeModuleSystemOptions ? true, ... }:
|
|
let options = (lib.evalModules { inherit modules; }).options;
|
|
in pkgs.buildPackages.nixosOptionsDoc ({
|
|
options = if includeModuleSystemOptions then
|
|
options
|
|
else
|
|
builtins.removeAttrs options [ "_module" ];
|
|
transformOptions = opt:
|
|
opt // {
|
|
# Clean up declaration sites to not refer to the Home Manager
|
|
# source tree.
|
|
declarations = map (decl:
|
|
if lib.hasPrefix hmPath (toString decl) then
|
|
gitHubDeclaration "nix-community" "home-manager"
|
|
(lib.removePrefix "/" (lib.removePrefix hmPath (toString decl)))
|
|
else if decl == "lib/modules.nix" then
|
|
# TODO: handle this in a better way (may require upstream
|
|
# changes to nixpkgs)
|
|
gitHubDeclaration "NixOS" "nixpkgs" decl
|
|
else
|
|
decl) opt.declarations;
|
|
};
|
|
} // builtins.removeAttrs args [ "modules" "includeModuleSystemOptions" ]);
|
|
|
|
hmOptionsDocs = buildOptionsDocs {
|
|
modules = import ../modules/modules.nix {
|
|
inherit lib pkgs;
|
|
check = false;
|
|
} ++ [ scrubbedPkgsModule ];
|
|
variablelistId = "home-manager-options";
|
|
};
|
|
|
|
nixosOptionsDocs = buildOptionsDocs {
|
|
modules = [ ../nixos scrubbedPkgsModule dontCheckDefinitions ];
|
|
includeModuleSystemOptions = false;
|
|
variablelistId = "nixos-options";
|
|
optionIdPrefix = "nixos-opt-";
|
|
};
|
|
|
|
nixDarwinOptionsDocs = buildOptionsDocs {
|
|
modules = [ ../nix-darwin scrubbedPkgsModule dontCheckDefinitions ];
|
|
includeModuleSystemOptions = false;
|
|
variablelistId = "nix-darwin-options";
|
|
optionIdPrefix = "nix-darwin-opt-";
|
|
};
|
|
|
|
release-config = builtins.fromJSON (builtins.readFile ../release.json);
|
|
revision = "release-${release-config.release}";
|
|
# Generate the `man home-configuration.nix` package
|
|
home-configuration-manual =
|
|
pkgs.runCommand "home-configuration-reference-manpage" {
|
|
nativeBuildInputs =
|
|
[ pkgs.buildPackages.installShellFiles pkgs.nixos-render-docs ];
|
|
allowedReferences = [ "out" ];
|
|
} ''
|
|
# Generate manpages.
|
|
mkdir -p $out/share/man/man5
|
|
mkdir -p $out/share/man/man1
|
|
nixos-render-docs -j $NIX_BUILD_CORES options manpage \
|
|
--revision ${revision} \
|
|
--header ${./home-configuration-nix-header.5} \
|
|
--footer ${./home-configuration-nix-footer.5} \
|
|
${hmOptionsDocs.optionsJSON}/share/doc/nixos/options.json \
|
|
$out/share/man/man5/home-configuration.nix.5
|
|
cp ${./home-manager.1} $out/share/man/man1/home-manager.1
|
|
'';
|
|
# Generate the HTML manual pages
|
|
home-manager-manual = pkgs.callPackage ./home-manager-manual.nix {
|
|
nmd = nmdSrc;
|
|
home-manager-options = {
|
|
home-manager = hmOptionsDocs.optionsJSON;
|
|
nixos = nixosOptionsDocs.optionsJSON;
|
|
nix-darwin = nixDarwinOptionsDocs.optionsJSON;
|
|
};
|
|
inherit revision;
|
|
};
|
|
html = home-manager-manual;
|
|
htmlOpenTool = pkgs.callPackage ./html-open-tool.nix { } { inherit html; };
|
|
in {
|
|
inherit nmdSrc;
|
|
|
|
options = {
|
|
# TODO: Use `hmOptionsDocs.optionsJSON` directly once upstream
|
|
# `nixosOptionsDoc` is more customizable.
|
|
json = pkgs.runCommand "options.json" {
|
|
meta.description = "List of Home Manager options in JSON format";
|
|
} ''
|
|
mkdir -p $out/{share/doc,nix-support}
|
|
cp -a ${hmOptionsDocs.optionsJSON}/share/doc/nixos $out/share/doc/home-manager
|
|
substitute \
|
|
${hmOptionsDocs.optionsJSON}/nix-support/hydra-build-products \
|
|
$out/nix-support/hydra-build-products \
|
|
--replace \
|
|
'${hmOptionsDocs.optionsJSON}/share/doc/nixos' \
|
|
"$out/share/doc/home-manager"
|
|
'';
|
|
};
|
|
|
|
manPages = home-configuration-manual;
|
|
|
|
manual = { inherit html htmlOpenTool; };
|
|
|
|
# Unstable, mainly for CI.
|
|
jsonModuleMaintainers = pkgs.writeText "hm-module-maintainers.json" (let
|
|
result = lib.evalModules {
|
|
modules = import ../modules/modules.nix {
|
|
inherit lib pkgs;
|
|
check = false;
|
|
} ++ [ scrubbedPkgsModule ];
|
|
};
|
|
in builtins.toJSON result.config.meta.maintainers);
|
|
}
|