This repository contains content and site generation scripts for my blog at https://jamescooke.info

My blog doesn't run a commenting system, but feedback and conversation are very welcome. There are three main channels:

• Drop me an email on hi AT jamescooke DOT info.

• Raise an Issue on GitHub and I'll reply as soon as I can. Issues that are comments have their own "blog comment" label for easy access.

The rest of this README is mainly notes to myself to install the required packages, build and deploy the generated HTML pages to GitHub's static sites.

Needs Python 3.9 or above.

In addition to this repository, Droidstrap theme and Pelican plugins are required.

git clone [email protected]:jamescooke/blog
git clone [email protected]:jamescooke/droidstrap
git clone --recursive https://github.com/getpelican/pelican-plugins

Note: cloning submodules with --recursive triggers calling ctags, which errors because paths aren't correct. This causes git to think that the submodules are not cloned, but they seem to work fine.

Make an output folder and then set up the virtualenv.

cd blog
mkdir output
bv 3.9
vvv
pip install -r requirements.txt

While in virtualenv, run dev server.

make devserver

Hit localhost.

Commit content and images as required, push to master. Then...

make github

The GitHub pages plugin does some funky stuff with the gh-pages branch. This can be cleaned up using make clean_github.

Requirements are managed with pip-tools.

Content in this repository is covered by the same license as the content when published in the blog at jamescooke.info.

Licensed under Creative Commons Attribution-ShareAlike 3.0 Unported License.