A static HTML blog generator.

blog, static, html, generator
pip install russell==0.5.8


Russell Build Status

A static HTML site generator written in Python 3.


The recommended way to install Russell is to first create a virtualenv and install russell:

$ mkdir /home/myuser/blog
$ cd /home/myuser/blog
$ python3 -m venv .venv
$ source ./.venv/bin/activate
$ pip install russell

Once that's done, you can either manually create the required files, or let Russell set up an example project for you:

$ russell setup .

Alternatively, you can install russell globally and let it create the virtualenv for you. Outside of any virtualenv:

$ pip install --user russell
$ ~/.local/bin/russell setup /home/myuser/blog


russell setup will set up an example configuration file and directory structure in the current working directory to get you started.

Creating pages/posts

russell new page "My Test Page" will create the file 'pages/my-test-page.md', which you can then open in your favourite text editor. The process is the same for russell new post. You can change the filename yourself to modify what the resulting .html file will be named.

Generating the blog

russell generate will create a file run.py which you can invoke to generate your static site.

To test your newly generated site, run russell serve.


Jinja2 is used as a templating engine, and all its features are present.

Read the Jinja2 documentation here: http://jinja.pocoo.org/

root_url has been added as a global variable, which you can use for generating URLs in your template.

The "index" and "archive" templates have the posts variable available. The "post" template has the post variable and "page" has the page variable. posts is an array of Post objects, the others are a single instance of either Post or Page.


Open an issue on GitHub if you have any problems or suggestions.


The contents of this repository is released under the MIT license. See the LICENSE file included for details.