There are plenty of static sites and blogs generators, so why yet another one?
Exactly because there are plenty of sites generators. This is probably a strong indication that none is satisfactory. At least, none was satisfactory for me. So I've made mine that exactly fits my needs:
- lightweight markup with as few limitation as possible: Markdown has been chosen because it's indeed lightweight and also allows to embed arbitrary HTML
- powerful templates: Jinja2 has been chosen because it is well documented while being full featured
- embedded Python within documents allowing easy extension: each document (in Markdown syntax) is actually also a Jinja2 template so that one can call Python to generate text in the document
- hierarchical configuration allowing easy sub-sites: at each point in a site hierarchy, changing options, templates, pictures, CSS style sheets, etc., for the whole sub-tree is a trivial operation
- easily extensible: adding new options or functions is as simple as
setting their value in a file
_config.py
and they are immediately available from every page and template - multiple blogs: each blog can exist at any point in the hierarchy
- few dependencies and easy installation: current dependencies are Jinja2, Markdown and LXML, installation is a straightforward as for a regular Python package
- last but not least, I wanted to have a clear understanding of the compilation process, which can obviously be achieved by writing the tool
If you wish mine to be yours also, please send me an email explaining why you don't want to code your own tool, nor use an existing one, but prefer to use mine. Indeed, there exists a huge gap between a tool that works for me and a tool with users, so, give me good reasons to release (this is the easy part) and then (here comes the hard part) start to document, to fix bugs, to provide support, etc.