nix-community.nixvim/docs/man/default.nix
Matt Sturgeon 61c44d7a7f
docs/man: minor cleanup
- Move lua filter to separate file
- Use a subshell to write `nixvim-header.5`
- Use bash function to avoid repetition
2025-05-17 03:30:13 +01:00

53 lines
1.2 KiB
Nix

{
lib,
options-json,
runCommand,
installShellFiles,
nixos-render-docs,
pandoc,
}:
let
manHeader =
runCommand "nixvim-general-doc-manpage"
{
nativeBuildInputs = [ pandoc ];
}
''
function mkMDSection {
file="$1"
pandoc --lua-filter ${./filter.lua} -f gfm -t man "$file"
}
mkdir -p $out
(
cat ${./nixvim-header-start.5}
${lib.concatMapStringsSep "\n" (file: "mkMDSection ${file}") [
../user-guide/helpers.md
../user-guide/faq.md
../user-guide/config-examples.md
]}
cat ${./nixvim-header-end.5}
) >$out/nixvim-header.5
'';
in
# FIXME add platform specific docs to manpage
runCommand "nixvim-configuration-reference-manpage"
{
nativeBuildInputs = [
installShellFiles
nixos-render-docs
];
}
''
# Generate man-pages
mkdir -p $out/share/man/man5
nixos-render-docs -j $NIX_BUILD_CORES options manpage \
--revision unstable \
--header ${manHeader}/nixvim-header.5 \
--footer ${./nixvim-footer.5} \
${options-json}/share/doc/nixos/options.json \
$out/share/man/man5/nixvim.5
compressManPages $out
''