adamchainz / blog-1

Blog running on jamescooke.info

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

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

Make an output folder and then set up the virtualenv.

cd blog
mkdir output
make -f Bakefile venv
make -f Bakefile install

Writing and testing

While in virtualenv, run dev server.

. venv/bin/activate
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.