This site is maintained using a small tool called sitegen, which I knocked together as an example of the smallest possible practical site generator I could think of. Since that initial version, it’s expanded a little bit to account for its potential use by my fellow tildans, but it’s fundamentally still very simple. It takes a directory full or ReST or Markdown files, sorts them, then processes each into HTML. Once it has that, it generates a homepage listing the entries and their titles. There’s no newsfeed generation, no complex metadata, nothing.
The real intelligence is in pandoc, which sitegen uses to process everything.
The plan is that sitegen should also be able to generate a gophermap too. This should be straightforward enough to add, but may require some additional intelligence as far as path and selector generation goes.
Copyright © Keith Gaughan, 2021