mirror of
https://github.com/nix-community/home-manager
synced 2024-11-23 03:29:45 +01:00
docs: rename generated manual to index.xhtml
The `nixos-render-docs` tool outputs XHTML formatted content. In order to convince browsers like `firefox` to treat the data as XHTML the extension must be `.xhtml` and not `.html`. Using the XHTML-formatted content as HTML is mainly an issue with self-closing `<a />` tags.
This commit is contained in:
parent
0da5767319
commit
93e2536db2
3 changed files with 18 additions and 8 deletions
|
@ -1,5 +1,11 @@
|
|||
{ stdenv, lib, documentation-highlighter, nmd, revision, home-manager-options
|
||||
, nixos-render-docs }:
|
||||
{ stdenv
|
||||
, lib
|
||||
, documentation-highlighter
|
||||
, nmd
|
||||
, revision
|
||||
, home-manager-options
|
||||
, nixos-render-docs
|
||||
}:
|
||||
let outputPath = "share/doc/home-manager";
|
||||
in stdenv.mkDerivation {
|
||||
name = "home-manager-manual";
|
||||
|
@ -46,7 +52,7 @@ in stdenv.mkDerivation {
|
|||
--toc-depth 1 \
|
||||
--section-toc-depth 1 \
|
||||
manual.md \
|
||||
out/index.html
|
||||
out/index.xhtml
|
||||
'';
|
||||
|
||||
installPhase = ''
|
||||
|
|
|
@ -1,6 +1,9 @@
|
|||
{ writeShellScriptBin, makeDesktopItem, symlinkJoin }:
|
||||
{ html, pathName ? "home-manager", projectName ? pathName
|
||||
, name ? "${pathName}-help" }:
|
||||
{ html
|
||||
, pathName ? "home-manager"
|
||||
, projectName ? pathName
|
||||
, name ? "${pathName}-help"
|
||||
}:
|
||||
let
|
||||
helpScript = writeShellScriptBin name ''
|
||||
set -euo pipefail
|
||||
|
@ -18,7 +21,7 @@ let
|
|||
echo "$0: unable to start a web browser; please set \$BROWSER"
|
||||
exit 1
|
||||
else
|
||||
exec "$BROWSER" "${html}/share/doc/${pathName}/index.html"
|
||||
exec "$BROWSER" "${html}/share/doc/${pathName}/index.xhtml"
|
||||
fi
|
||||
'';
|
||||
|
||||
|
@ -30,7 +33,8 @@ let
|
|||
exec = "${helpScript}/bin/${name}";
|
||||
categories = [ "System" ];
|
||||
};
|
||||
in symlinkJoin {
|
||||
in
|
||||
symlinkJoin {
|
||||
inherit name;
|
||||
paths = [ helpScript desktopItem ];
|
||||
}
|
||||
|
|
|
@ -9,7 +9,7 @@
|
|||
};
|
||||
|
||||
nmt.script = ''
|
||||
assertFileExists home-path/share/doc/home-manager/index.html
|
||||
assertFileExists home-path/share/doc/home-manager/index.xhtml
|
||||
assertFileExists home-path/share/doc/home-manager/options.html
|
||||
assertFileExists home-path/share/doc/home-manager/options.json
|
||||
assertFileExists home-path/share/man/man1/home-manager.1
|
||||
|
|
Loading…
Reference in a new issue