Ozymandias

A full-featured static site framework built with Hakyll and Pandoc. Designed for long-form writing, research, music, and creative work.

What's included

• Sidenotes — footnotes render in the margin on wide screens, inline on mobile.
• Epistemic profiles — tag essays with confidence, evidence quality, importance, and stability; readers see a compact credibility signal before committing to read.
• Backlinks — two-pass wikilink resolution with automatic backlink sections.
• Score reader — swipeable SVG score viewer for music compositions.
• Typography — dropcaps, smallcaps auto-detection, abbreviation tooltips, old-style figures.
• Math — KaTeX rendering for inline and display equations.
• Citations — Pandoc citeproc with Chicago Notes; bibliography and further-reading sections.
• Search — Pagefind client-side full-text search.
• Semantic search — optional embedding pipeline (sentence-transformers + FAISS) for "similar links."
• Settings — dark mode, text size, focus mode, reduce motion.
• Wikilinks — [[Page Name]] and [[Page Name|display text]] syntax.
• Atom feeds — site-wide and per-section (e.g., music-only).
• Library — configurable portal taxonomy that groups content by tag hierarchy.
• Version history — git-derived stability heuristic with manual history annotations.
• Reading mode — dedicated layout for poetry and fiction.
• GPG signing — optional per-page detached signatures.

Quickstart

# Clone and enter the repo
git clone <your-fork-url> my-site && cd my-site

# Edit your identity and navigation
$EDITOR site.yaml

# Build and serve locally (requires GHC 9.6+, cabal, pagefind)
make dev

make dev builds with drafts visible and starts a local server on :8000. For production: make build (one-shot build into _site/).

Prerequisites

• GHC 9.6+ and cabal-install — for the Haskell build pipeline.
• Pagefind — client-side search index (npm i -g pagefind or via your package manager).
• cwebp (optional) — for automatic WebP image conversion (pacman -S libwebp / apt install webp).
• Python 3.12+ and uv (optional) — for the embedding pipeline (uv sync to set up).

Configuration

All site identity, navigation, and taxonomy live in site.yaml:

site-name:   "My Site"
site-url:    "https://example.com"
author-name: "Your Name"

nav:
  - { href: "/",             label: "Home"    }
  - { href: "/library.html", label: "Library" }

portals:
  - { slug: "writing", name: "Writing" }
  - { slug: "code",    name: "Code"    }

See the comments in site.yaml for the full schema.

Project structure

build/          Haskell source — Hakyll rules, Pandoc filters, compilers
templates/      Hakyll HTML templates and partials
static/         CSS, JS, fonts, images (copied to _site/)
content/        Markdown source — essays, blog, poetry, fiction, music
data/           Bibliography, annotations, citation style
tools/          Shell/Python build-time utilities
site.yaml       Site-wide configuration
Makefile        Build, deploy, dev targets

Content types

Type	Path	Template
Essay	content/essays/*.md	essay.html
Blog post	content/blog/*.md	blog-post.html
Poetry	content/poetry/*.md	reading.html
Fiction	content/fiction/*.md	reading.html
Composition	content/music/<slug>/index.md	composition.html
Page	content/*.md	page.html

Deployment

The included make deploy target:

1. Runs make clean && make build && make sign
2. Rsyncs _site/ to a VPS (configured via .env)
3. Pushes to the git remote

Set VPS_USER, VPS_HOST, and VPS_PATH in .env (gitignored).

License

The framework code (everything outside content/) is MIT. The demo content under content/ is public domain. Your own content is yours — add whatever license you choose.

---

"My name is Ozymandias, King of Kings; / Look on my Works, ye Mighty, and despair!" — the name is a reminder that all frameworks are temporary, but the writing you put in them might not be.