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.
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
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
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
posts is an array of
Post objects, the others are a single instance of
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.