feat: nix: add a new mise task and nix flake output to generate NixOS docs

Adds a new Nix flake output `headplane-nixos-docs` which generates a
Markdown page with all NixOS `services.headplane.settings.*` options.

Replaces existing handwritten options documentation.
This commit is contained in:
Igor Ramazanov 2025-07-29 15:22:28 +00:00 committed by Aarnav Tale
parent cdcb38f11e
commit fdbfe584c5
7 changed files with 1331 additions and 482 deletions

View file

@ -32,6 +32,15 @@ run = [
'go build -ldflags="-s -w -X main.imageTag=$IMAGE_TAG" -o build/sh ./cmd/fake_sh'
]
[tasks.build-nixos-docs]
alias = ["nixos-docs"]
description = "Builds NixOS module documentation"
run = [
'nix build .#headplane-nixos-docs',
'cp --dereference --force ./result ./docs/NixOS-options.md',
'sed -i "s;\[/nix.*;\[nix/options.nix\](https://github.com/tale/headplane/blob/main/nix/options.nix);" ./docs/NixOS-options.md'
]
[tasks.generate-caddy-certs]
alias = ["mkcert"]
dir = "{{cwd}}/test/caddy/certs"