Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Personal site - a simple RST blog using Fabric for deployment.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 www
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rst
Octocat-spinner-32 fabfile.py
README.rst

codeinthehole.com

Nothing special here - I just wanted to write my own blog so I could optimise it for my own needs. The aim was to write articles in RST using vim, then have a simple preview and publish mechanism.

The blog is a simple Django project which uses RST files as a source for creating a simple Article model. Fabric is used to publish articles to the production site.

See Rewriting codeinthehole.com for more details.

It's on my to-do list to package this up (name ReStructured Blog) and put it on PyPI.

Usage

How to publish an article

Create an RST article file within the posts folder:

vim posts/my-new-article.rst

Preview locally using:

./manage.py rsb_article posts/my-new-article.rst
./manage.py runserver

Note this renames the file to include the PK, which is helpful when article files are renamed, but annoying if you still have it open in vim. You have been warned.

Repeat the above steps until you are ready to publish, then run:

fab prod publish:posts/0034-my-new-article.rst

Push it to Github so you've got a backup.

How to update the site

If you have changes to the django project or the static assets, you'll need to run:

fab prod deploy
Something went wrong with that request. Please try again.