eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions
blumeops/docs/reference/services/docs.md
Erich Blume 5b52f18356 cv+docs: relocate content under ~/blumeops/{cv,docs} 
Keeps blumeops-managed state grouped under a single namespace in the
home dir rather than scattered top-level dirs. Caddy block paths are
derived from cv_content_dir / docs_content_dir, so the role-defaults
edit propagates automatically.

Validated end-to-end on indri: tarballs extracted to the new paths,
sentinels written, second run is idempotent. Old ~/cv and ~/docs from
the earlier validation run were removed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 14:54:01 -07:00

1.7 KiB
Raw Permalink Blame History

title modified last-reviewed tags
Docs 2026-04-29 2026-04-29
service
documentation

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

  1. Source: Markdown files in docs/ with Obsidian-compatible wiki-links
  2. Build: Build BlumeOps Forgejo workflow runs towncrier + Quartz, uploads tarball as a release asset, and bumps docs_version in the ansible role
  3. 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

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

Related