This is really just a makefile for turning Markdown and Sass into HTML and CSS to produce a simple static blog. There are no scripts or binaries.

A demo of the generated site template is available at https://cosine.blue/red/.

A brief summary of the Makefile is this:

src/*.md         →  www/*.html
src/posts/*.md   →  www/*.html + www/index.html
src/main.sass    →  www/main.css

src/header.html     Prepended to every page
src/footer.html     Appended to every page

Posts are automatically listed in a section appended to the index page (src/index.md → index.html). The list is sorted alphabetically, so if you name your posts in the form YYYY-MM-DD-*.md, they will be listed in chronological order.

GNU Make is required. To build the HTML pages, you need Pandoc. To build the style sheet, you need a Sass preprocessor such as sassc (edit Makefile to use another implementation).

Edit and create files within the src/ directory to determine the site's content. Then build:

make

You can enter

make clean

to remove all the files that were generated by make.

If you modify the rsync command in the deploy task in the Makefile, you can deploy the generated site to a webserver by running

make deploy

A few similar tools I've seen are bake, pdsite, and tundra.sh.