Docs (Quartz)

Documentation site built with Quartz.

Quick Reference

Property	Value
Public URL	https://docs.eblu.me (via flyio-proxy)
Private URL	`docs.ops.eblu.me` (Caddy on indri)
Deployment	Ansible role `docs` on indri (no daemon — Caddy serves files directly)
Content dir	`~/blumeops/docs/content/` on indri
Source	`docs/` directory in blumeops repo
Build	Forgejo workflow `build-blumeops.yaml`

Migrated from minikube to indri-native on 2026-04-29 (see docs-on-indri).

Architecture

Source: Markdown files in docs/ with Obsidian-compatible wiki-links
Build: Build BlumeOps Forgejo workflow runs towncrier + Quartz, uploads tarball as a release asset, and bumps docs_version in the ansible role
Deploy: ansible role downloads the tarball into ~/blumeops/docs/content/ on indri; Caddy serves the directory directly with Quartz-style try_files (path → path/ → path.html → 404.html)

Configuration

Quartz config: quartz.config.ts
Layout: quartz.layout.ts
Ansible role: ansible/roles/docs/
Caddy entry: ansible/roles/caddy/defaults/main.yml (kind: static, try_html: true)

Release flow

Run the Build BlumeOps workflow → builds tarball, creates release, bumps docs_version in the ansible role and pushes
Run mise run provision-indri -- --tags docs from gilbert
Purge the Fly.io proxy cache so the new content is fetched

docs-on-indri — Operations how-to
cv — Similar architecture
forgejo — Build workflows