hoosier ee

wholesome midwestern tech/design weblog

Static Site Generator

2016-12-08

Originally this site was built using Jekyll, specifically a preconfigured kit designed by Barry Clark called Jekyll Now.

I ended up rolling my own version because:

Currently this software is useful to me, and probably just me. But still, here's some more information about it.

Features

One script (newpost.ijs) generates a mostly empty blog post, with the filename in the right format. Another script (makesite.ijs) builds the site as a whole:

  1. concatenate the header and footer html around every page
  2. create previous/next links for each blog post
  3. generate a table of contents

Some to-dos for this script include generating a sitemap and atom feed.

Usage

My workflow is very simple and fairly manual, but it's easy for me to understand.

  1. Navigate to the site's repo in the terminal
  2. Start an http server locally with python -m SimpleHTTPServer.
  3. Create a new post with ./newpost.ijs.
  4. Write a post in HTML, occasionally check the build with ./makesite.ijs.
  5. Push to GitHub when done.