HeadlinesBriefing favicon HeadlinesBriefing.com

Rebuilding a Lisp‑Based Static Site Generator

Hacker News •
×

Modern web builders often trade clean text for massive node_modules and convoluted frameworks. Frustrated, the author clings to Emacs, the single‑threaded Lisp machine that powers Org‑mode. Org‑mode offers a structural system that adapts to complex logic without extra syntax, making it ideal for managing notes, finances, and life in one place, and daily tasks effortlessly.

Wanting to publish Org notes without external dependencies, the author first tried Org‑publish. Hours of tweaking produced brittle code, broken URLs, and a painful sitemap routine. The result was a tangled, hook‑heavy system that drifted far from the clean output the author sought and in the process of creating static sites remains a challenge today.

Next, the author evaluated alternatives: a lightweight wiki, Hugo with ox‑hugo, and a Go‑based static generator. Each fell short—either by adding bulk, forcing Markdown, or requiring a specific directory layout. Finally, Weblorg surfaced as the most promising, unopinionated tool that matched the author’s composability needs and provides a clean template system without libraries in Elisp.

Armed with Weblorg’s skeleton, the author rebuilt the engine in pure Elisp, replacing brittle string templates with a two‑pass compiler. This overhaul restores true Lisp composability, eliminates hard‑coded specifiers, and delivers clean HTML output directly from Org files—all without adding new dependencies. The result is a lightweight, fully controllable static site generator for Emacs users.