Habu is likely the simplest static blog generator you'll encounter, no bullshit. If you're techie enough and need a simple page to publish your work and if you share my disgust and terror for blog platforms with massive codebases and my repulsion for all those byzantine Ruby static generators, you might find this little tool of some use.
Firstly, you can install all the required dependencies with: More Info »
pip install Jinja2 Markdown Pygments PyYAML
Now just download and extract Habu somewhere, you'll find the main script habu.py with the following available command line options:
usage: habu.py [-h] [-s] [-p] -d DESTINATION
optional arguments:
-h, --help show this help message and exit
-s, --static Install static files
-p, --pages Generate static pages
-d DESTINATION, --destination DESTINATION
Specify the destination folder where to install the
files
You simply need to execute python habu.py -d /path/to/dest and the script will automatically process the available blog posts and generate the resulting HTML pages in the destination folder.
By providing the options --static or --pages you instruct Habu to respectively install the static files (CSS, JavaScript and so on) and generate the static pages.
All available blog posts are stored in the posts/ directory and they consist in a set of YAML headers followed by the body, separated by an empty line:
Title: Blog Post
Slug: blog-post
Data: 1971-01-01 00:00:00
Blog post content.
The blog post content can be defined with the popular Markdown syntax, which makes the editing very easy and flexible, or with pure HTML.
Habu also integrates a Pygments based pre-processor, which will highlight code blocks according to the specified programming language.
