Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Personal site - a simple RST blog using Fabric for deployment.
CSS Python Matlab TeX Shell JavaScript PHP
branch: master
Failed to load latest commit information.
www Updated makefile example
.gitignore
LICENSE Added MIT license
README.rst Fixed typos in README
fabfile.py Generate static files earlier in deployment
makefile Add db recreation target to makefile

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.