jamescooke.info blog

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

Blog post comments

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.

Getting up and running

Needs Python 3.9 or above.

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

git clone git@github.com:jamescooke/blog
git clone git@github.com: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

Writing and testing

While in virtualenv, run dev server.

make devserver

Hit localhost.

Publishing

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

Requirements are managed with pip-tools.

License

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.