Gitpages

Tue, 14 Apr 2026 00:00:00 +0000

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.

Static Git Project Site Generators

Fri, 30 Jan 2026 00:00:00 +0000

A while ago, I took down my git forge and replaced it with pgit. It more or less does what I want, but I have a few gripes:

It doesn’t render the README into HTML
It doesn’t allow people to view images I’ve committed
I don’t care for monospace fonts

After my daughter messaged me asking for a wiring diagram that pgit wasn’t making available, I started looking for a replacement.

The Cast

pgit: What I’m using now. It checks most of my boxes, but I need a few more things.
stagit: Same complaints as pgit, plus it’s even more obtuse to non-hackers.
GitGen: Fixes the README issue, but requires images to be hosted elsewhere. Also doesn’t let you read any of the files in the browser.
gitmal: Fixes README and image hosting, but doesn’t provide any link to clone the repo. No option to limit commit history (not good for big repos)
itsy-gitsy: Hides the README behind a confusing entry page, no option to limit commit history.
git-arr: README is buried, otherwise I like it.
git2html: Not designed for general public use.
stagen: I like that it uses templates, maybe I’ll fork it.

I’m kind of disappointed by everything, sigh.

Git-Static-Site on Neale Pickett

Gitpages

Static Git Project Site Generators

The Cast