mirror of
https://github.com/nix-community/home-manager
synced 2024-11-08 12:19:43 +01:00
25fd5eb4ba
This commit extracts the htmlOpenTool from `nmd` into a module in the home-manager docs directory. This is done to provide feature parity with the documentation generated using the docbook .xml files.
36 lines
1,013 B
Nix
36 lines
1,013 B
Nix
{ writeShellScriptBin, makeDesktopItem, symlinkJoin }:
|
|
{ html, pathName ? "home-manager", projectName ? pathName
|
|
, name ? "${pathName}-help" }:
|
|
let
|
|
helpScript = writeShellScriptBin name ''
|
|
set -euo pipefail
|
|
|
|
if [[ ! -v BROWSER || -z $BROWSER ]]; then
|
|
for candidate in xdg-open open w3m; do
|
|
BROWSER="$(type -P $candidate || true)"
|
|
if [[ -x $BROWSER ]]; then
|
|
break;
|
|
fi
|
|
done
|
|
fi
|
|
|
|
if [[ ! -v BROWSER || -z $BROWSER ]]; then
|
|
echo "$0: unable to start a web browser; please set \$BROWSER"
|
|
exit 1
|
|
else
|
|
exec "$BROWSER" "${html}/share/docs/${pathName}/index.html"
|
|
fi
|
|
'';
|
|
|
|
desktopItem = makeDesktopItem {
|
|
name = "${pathName}-manual";
|
|
desktopName = "${projectName} Manual";
|
|
genericName = "View ${projectName} documentation in a web browser";
|
|
icon = "nix-snowflake";
|
|
exec = "${helpScript}/bin/${name}";
|
|
categories = [ "System" ];
|
|
};
|
|
in symlinkJoin {
|
|
inherit name;
|
|
paths = [ helpScript desktopItem ];
|
|
}
|