A command line tool to render static web pages from restructured and Jinja templates. Yeah, I know...
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples/simple_jinja
lumberjack
.coveragerc
.gitignore
.travis.yml
Makefile
README.rst
buildout.cfg
setup.cfg
setup.py
travis.cfg

README.rst

lumberjack

A commandline tool to render static web sites from restructured text with jinja templates. In other words: yet another static site generator.

"He walks down trees, he parses files mumble, mumble, suspenders and a bra!"

Why another one?

The existing crop of (python based) site generators all make a great deal of assumptions regarding their usage. Even those that come closest to our idea of a general 'HTML compiler' (the excellent mynt and Blogofile) made implementing our use cases unneccessarily cumbersome.

Specifically, lumberjack is designed to:

  • build general-purpose websites (IOW sites that are not blogs, like Pelican and Blogofile do)
  • explicitly support existing tools such as GruntJS and Bower (no need to re-invent the wheel here Python people, the JS folks got this down to a science!)
  • be fast (like already mynt is, for example). Rendering a typical site should never take longer than 1s.
  • complete separation of content and theme

Design

  • each node can have (YAML) meta data by providing a *.meta file
  • accordingly, .meta contains the meta data for a directory
  • .meta properties are inherited by default
  • properties that are not supposed to be inherited need to be put into a local section

TravisStatus