docs: add pagefind

This commit is contained in:
Peder Bergebakken Sundt 2023-09-22 14:47:39 +02:00
parent 790cd49f1f
commit f24dee8292
1 changed files with 77 additions and 15 deletions

View File

@ -1,7 +1,55 @@
{ config, pkgs, lib, mkDomain, ... }: { config, pkgs, lib, mkDomain, flakes, ... }:
let
cfg = config.services.docs-to-host;
# https://pagefind.app/docs/ui-usage/
pagefind-default-ui = ''
<link href="/pagefind/pagefind-ui.css" rel="stylesheet">
<script src="/pagefind/pagefind-ui.js"></script>
<div id="search"></div>
<script>
window.addEventListener('DOMContentLoaded', (event) => {
new PagefindUI({ element: "#search", showSubResults: true });
});
</script>
'';
# TODO: symlink dotfiles to $out
# TODO: ability to set fallback for unknown languages, instead of --force-language en
# TODO: for some reason pagefind is not able to work with symlinks as input. is it a one-file-system restriction?
# TODO: for some reason pagefind requires write access to other files than pagefind/
addPagefindIndex = root: pkgs.runCommand "${root.name}-with-pagefind" {
nativeBuildInputs = [ cfg.pagefind.package pkgs.rsync ];
} ''
#mkdir $out
#cd $out
#ln -s ${root}/* .
# workaround pagefind shortcomings...
mkdir foobar
cd foobar
time rsync -r --chmod +rw --copy-links ${root}/ .
test ! -e pagefind || {
>&2 echo 'ERROR: `root` input has `pagefind` already in it!'
false
}
pagefind --site . --force-language en
mkdir $out
ln -s ${root}/* $out/
cp -a pagefind $out
'';
in
{ {
options = with lib; { options = with lib; {
#services.docs-to-host.enable = mkEnable "docs-to-host"; services.docs-to-host.enable = mkEnableOption (lib.mdDoc "docs-to-host");
services.docs-to-host.pagefind = {
enable = mkEnableOption (lib.mdDoc "pagefind default on index of docs");
package = mkPackageOptionMD flakes.unstable.pkgs "pagefind" { };
};
services.docs-to-host.docs = mkOption { services.docs-to-host.docs = mkOption {
type = types.listOf (types.submodule { type = types.listOf (types.submodule {
options = { options = {
@ -14,7 +62,7 @@
type = types.str; type = types.str;
example = "foobar.html"; example = "foobar.html";
default = ""; default = "";
description = lib.mdDoc "The basename at which the documentation will be linked"; description = lib.mdDoc "The basename to which the documentation entry will be linked. Not needed if index.html exists.";
}; };
path = mkOption { path = mkOption {
type = types.path; type = types.path;
@ -36,21 +84,35 @@
# TODO: host man pages (man -H) # TODO: host man pages (man -H)
config = let config = let
cfg = config.services.docs-to-host; mkLinkFarmEntry = {dirname, path, ...}: {
mkRow = {dirname, basename, path, desc}: ''<tr><td><a href="${dirname}/${basename}">${dirname}</a><td>${desc}''; name = dirname;
mkEntry = {dirname, basename, path, desc}: { name = dirname; path = path; }; path = path;
in { };
services.nginx.virtualHosts.${mkDomain "docs"} = { mkRow = {dirname, basename, path, desc}:
forceSSL = true; # addSSL = true; ''<tr><td><a href="${dirname}/${basename}">${dirname}</a><td>${desc}'';
enableACME = true; #useACMEHost = acmeDomain;
root = pkgs.linkFarm "docs-html" ([{name = "index.html"; path = pkgs.writeText "docs-index.html" '' root = pkgs.linkFarm "docs-html" ([{name = "index.html"; path = pkgs.writeText "docs-index.html" ''
<!DOCTYPE html> <!DOCTYPE html>
${lib.optionalString cfg.pagefind.enable
pagefind-default-ui
}
<table> <table>
<tr><th>URL<th>Desc <tr><th>URL<th>Desc
${lib.concatStringsSep "\n" ( builtins.map mkRow cfg.docs ) } ${lib.concatStringsSep "\n" ( builtins.map mkRow cfg.docs ) }
</table> </table>
''; '';
}] ++ (builtins.map mkEntry cfg.docs)); }] ++ (builtins.map mkLinkFarmEntry cfg.docs));
in {
# i assume we import this if needed
services.docs-to-host.enable = lib.mkDefault true;
services.docs-to-host.pagefind.enable = lib.mkDefault true;
services.nginx.virtualHosts.${mkDomain "docs"} = lib.mkIf cfg.enable {
forceSSL = true; # addSSL = true;
enableACME = true; #useACMEHost = acmeDomain;
root = if cfg.pagefind.enable
then addPagefindIndex root
else root;
}; };
}; };
} }