Overview
sushy is the filesystem-backed wiki and blog engine that formerly powered taoofmac.com. Each page is a directory, content remains editable with ordinary tools, and a disposable SQLite index provides search and link metadata without becoming the source of truth.
The codebase is written largely in Hy and is being brought up to date for current Hy releases. It is a cleaned-up legacy system, not a new publishing platform.
How it works
A content tree holds pages and their assets. RFC2822-style front matter carries metadata, while the file extension or an explicit content type selects the renderer for Markdown, Textile, HTML, plain text and legacy ReStructuredText support.
An indexer updates SQLite full-text data from the content tree. The HTTP layer renders pages on demand through the selected theme and supports ETag, Last-Modified and HEAD handling to avoid unnecessary work. Atom feeds, sitemap and OpenSearch output are generated from the same content and index where those legacy features remain enabled.
Features
Filesystem source of truth
Pages, metadata and attachments remain ordinary files arranged as one directory per page.
Multiple renderers
Markdown, Textile, HTML and plain text are supported, with legacy ReStructuredText support and only preliminary notebook handling.
Full-text indexing
SQLite provides disposable search and internal metadata while remaining safe to rebuild from content.
HTTP caching
ETag, Last-Modified and HEAD responses make on-demand rendering practical behind a normal web server.
Publishing surfaces
Includes Atom feeds, sitemap, OpenSearch and blog navigation alongside wiki pages.
Deliberate omissions
No web editor, revision history or comments; site thumbnailing was moved into a separate application.
Architecture
Posts
2026-07-29
Python