1
0
mirror of https://github.com/nix-community/home-manager synced 2024-06-16 11:38:31 +02:00
home-manager/docs/home-manager-manual.nix
Viktor Kronvall 80ac72bf03 docs: render without deprecated optionsDocBook
The `optionsDocBook` function is deprecated in nixpkgs since
nixos-23.11. This commit updates the manual and manpages to
use commonmark formatted documentation instead of the deprecated
docbook format.
2023-12-07 21:27:38 +09:00

58 lines
1.7 KiB
Nix

{ stdenv, home-manager-render-docs, optionsDoc, lib, documentation-highlighter
, nmd, revision, home-manager-options }:
let outputPath = "share/docs/home-manager";
in stdenv.mkDerivation {
name = "nixpkgs-manual";
nativeBuildInputs = [ home-manager-render-docs ];
src = ./manual;
buildPhase = ''
mkdir -p out/media
mkdir -p out/highlightjs
cp -t out/highlightjs \
${documentation-highlighter}/highlight.pack.js \
${documentation-highlighter}/LICENSE \
${documentation-highlighter}/mono-blue.css \
${documentation-highlighter}/loader.js
substituteInPlace ./options.md \
--replace \
'@OPTIONS_JSON@' \
${home-manager-options.home-manager}/share/doc/nixos/options.json
substituteInPlace ./nixos-options.md \
--replace \
'@OPTIONS_JSON@' \
${home-manager-options.nixos}/share/doc/nixos/options.json
substituteInPlace ./nix-darwin-options.md \
--replace \
'@OPTIONS_JSON@' \
${home-manager-options.nix-darwin}/share/doc/nixos/options.json
home-manager-render-docs manual html \
--manpage-urls ./manpage-urls.json \
--revision ${lib.trivial.revisionWithDefault revision} \
--stylesheet ${nmd}/static/style.css \
--stylesheet ${nmd}/static/highlightjs/tomorrow-night.min.css \
--script ${nmd}/static/highlightjs/highlight.min.js \
--script ${nmd}/static/highlightjs/highlight.load.js \
--toc-depth 1 \
--section-toc-depth 1 \
manual.md \
out/index.html
'';
installPhase = ''
dest="$out/${outputPath}"
mkdir -p "$(dirname "$dest")"
mv out "$dest"
mkdir -p $out/nix-support/
echo "doc manual $dest index.html" >> $out/nix-support/hydra-build-products
'';
}