Introduction

Citing staticjinja’s documentation, “most static site generators are cumbersome to use”. While I fully agree, and while I find staticjinja to be an awesome piece of software, there’s still some gaps here and there that needs to be filled in order to be able to generate a static website that will actually be ready for real world usage.

staticjinjaplus try to fill these gaps, while still being built on staticjinja and its philosophy: keep it simple, stupid.

Note

staticjinjaplus is opinionated: choices have been made to cover some use cases, but not all. This is not your average static site generator.

Features

All of staticjinja’s features, plus:

  • Simple, file-based configuration to centralize a handful of configuration values
  • Generic Markdown support (not your usual “pages” or “articles/blog posts” feature)
  • Build improvements
    • Automatically copy static files to output directory
    • Define Jinja and staticjinja initialization parameters in a config file
    • Define webassets bundles to allow CSS/JS concatenation/minification
    • Automatically minify XML (including HTML, RSS and Atom)/JSON output
  • Jinja improvements
    • A few new Jinja globals/filters to make your life easier
    • Autoescape is enabled for XML, HTML, RSS and Atom templates
  • Serve the generated site through a local HTTP server
    • URL rewrite emulation (for HTML files)
    • Custom HTTP error pages emulation
    • IPv6 loopback address support
    • Serve proper MIME type for RSS and Atom files

Planned features

  • Rebuild site on assets/static files change
  • Generic i18n and l10n support (powered by Babel)