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 email@example.com:jamescooke/blog git clone firstname.lastname@example.org:jamescooke/droidstrap git clone --recursive https://github.com/getpelican/pelican-plugins
Note: cloning submodules with
--recursivetriggers 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.
Commit content and images as required, push to master. Then...
The GitHub pages plugin does some funky stuff with the
gh-pages branch. This
can be cleaned up using
Requirements are managed with
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.