chore: add docs & CI

This commit is contained in:
technofab 2025-10-06 17:18:22 +02:00
parent 3363059b65
commit f8f5dbd535
No known key found for this signature in database
18 changed files with 407 additions and 26 deletions

74
nix/repo/docs.nix Normal file
View file

@ -0,0 +1,74 @@
{inputs, ...}: let
inherit (inputs) pkgs utils doclib;
optionsDoc = doclib.mkOptionDocs {
inherit (utils) module;
roots = [
{
url = "https://gitlab.com/rensa-nix/utils/-/blob/main/lib";
path = "${inputs.self}/lib";
}
];
};
optionsDocs = pkgs.runCommand "options-docs" {} ''
mkdir -p $out
ln -s ${optionsDoc} $out/options.md
'';
in
(doclib.mkDocs {
docs."default" = {
base = "${inputs.self}";
path = "${inputs.self}/docs";
material = {
enable = true;
colors = {
primary = "red";
accent = "red";
};
umami = {
enable = true;
src = "https://analytics.tf/umami";
siteId = "1e063417-931a-4fb7-81a1-fc506372ebcc";
domains = ["utils.rensa.projects.tf"];
};
};
macros = {
enable = true;
includeDir = toString optionsDocs;
};
config = {
site_name = "Utils";
site_url = "https://utils.rensa.projects.tf";
repo_name = "rensa-nix/utils";
repo_url = "https://gitlab.com/rensa-nix/utils";
extra_css = ["style.css"];
theme = {
logo = "images/logo.svg";
icon.repo = "simple/gitlab";
favicon = "images/logo.svg";
};
nav = [
{"Introduction" = "index.md";}
{"Utility Functions" = "utils.md";}
{"Options" = "options.md";}
];
markdown_extensions = [
{
"pymdownx.highlight".pygments_lang_class = true;
}
"pymdownx.inlinehilite"
"pymdownx.snippets"
"pymdownx.superfences"
"pymdownx.escapeall"
"fenced_code"
"attr_list"
{
"toc".permalink = "#";
}
];
};
};
}).packages
// {
inherit optionsDocs;
}