powered by

of course it was time to diy a static blog generator, why wouldn’t he do such a thing?

Aim: To have a static blog build engine that just uses a Makefile for any configuration and deployment, and uses markup that’s simple and compatable with other Static Site Generators

Result: All settings in the Makefile and (if wanted) a css file located in $(SRCDIR).

Most markup I use for this site is shown at the test page.

Needed software

Optional software

File conventions

Build and deploy

make -j ; make deploy

Makefile

See make help for more options:


Usage: make [flags] [option]
  make all           Build everything
  make pages         Build markdown pages
  make prime         Build primary pages
  make images        Build images
  make push deploy   Push/deploy site via rsync
  make serve test    Start local test server
  make open          Open main page in browser
  make back backup   TAR and backup (eg ../backup/site.YYYY-MM-DD.tar.gz)
  make clean         Remove generated files
  make tidy          Tidy extra files
  make nomac         Tidy mac files
  make index         Build index files
  make posts         Build post files
  make archive       Build archive files
  make lists         Build list files
  make tables        Build table files
  make rpg           Build rpg files
  make reviews       Build reviews files
  make howtos        Build howtos files
  make drafts        Build drafts files
  make css           Build css file
  make favicon       Build favicon file
  make sitemap       Build sitemap file
  make robots        Build robots file
  make about         About this Makefile
  make copying       Copyright notice
  make help          Show this help

Useful make flags:
  make -n  dry run
  make -j  run simultaneous jobs
  make -B  force make target

You can override Makefile vars like so:
  make site_css=pandoc.css

Licence

Copyright (C) 2021 David Marsh
rdmarsh@gmail.com http://rdm.sh/powered_by.html

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program comes with ABSOLUTELY NO WARRANTY.
This is free software, and you are welcome to redistribute it
under certain conditions. View the file "LICENSE" for details.

todo

Check todo for things left todo or ideas I want to try.