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.