Welcome to Habu.
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:
pip install Jinja2 Markdown Pygments PyYAML
Now just download and extract Habu somewhere, you'll find the main script
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
--pages you instruct Habu to
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.
This is pretty much it for now.