Bagpipe Read Me

2026-Apr-14

Somebody in Australia emailed me about my bagpipe project, and it lit a fire under me to clean things up a bit.

In a previous entry, I complained that I couldn’t find a “static site generator for git” which did what I wanted. What I wanted was to just render the files checked in to HEAD in the browser, and provide instructions about how to clone the repo for deeper inspection.

Well, I wrote it, and now it’s serving up my less-embarassing Uilleann README.


The generator doesn’t do much: it writes all the files in HEAD, then writes an index.html that lists all the files and provides a little skeleton HTML. Everything else is handled in JavaScript. It really wasn’t too difficult, and now I won’t have to think about the web presence of my projects again, I hope.

I called it gitpages because I’m tired of creative names that don’t explain what the thing does.