a personal blog, starting 2021

This is the generator for the site, served at: instantiator.dev

Generated site content is pushed to instantiator/instantiator.github.io and served from there with GitHub Pages.

prequisites

The site is generated by hugo. On OS X, install from brew:

brew install hugo

submodules

  • The themes/uBlogger folder is a submodule of the uBlogger theme.
  • The public folder is a submodule of the instantiator/instantiator.github.io repository.

scripts

  • init-repo-submodules.sh - use to initialise all submodules in this repo after first cloning.
  • update-repo-submodules.sh - use to update all submodules in this repo.
  • test-server.sh - uses hugo to run a local site, displaying the pages as they are.
  • deploy-site.sh - uses hugo to deploy the new site and push to the instantiator/instantiator.github.io repository, where it will be served with GitHub Pages.

submodules

images

  • Place images in the static/ folder.
  • Refer to them at /...