Skip to content

tomster/lumberjack

Repository files navigation

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

About

A command line tool to render static web pages from restructured and Jinja templates. Yeah, I know...

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages