Skip to main content

Python static web site generators for blogs

There is a really awesome comparison over all static web site generators here. Not only does it list what type of web site the library/tool is aiming for, but it also lists the supported languages.

What am I looking for?

  • Simple to use tool, not too complex for somebody with little frontend experience.
  • Nice design available, so that no CSS code needs to be touched
  • Nice-to-have: Possibility to extend it easily (e.g. create custom theme)
  • Nice-to-have: Switch to another tool

Python Blog Generators

When looking at "Blog" section and the ones for Python, that still seem to be maintained (with >50 Github Stars and recent commits):

  • Blag (docs, demo)
    • Design: Nice look and simple
    • Featuers: Jinja2, live reload
  • Pelican (docs, demos)
    • Design: Many not so-nice looking themes, themes as plugins
    • Featuers: Jinja2, live reload, Code Syntax Highlighting, Linking to internal content, Importing Tool, Chronological content as well as static pages, multilingual support
  • Nikola (docs, demos)
    • Design: Ugly by default, several themes as plugins, with some of themes (e.g. hack) looking nice
    • Featuers: Mako or Jinja2, many input formats incl. rst, Markdown, IPython Notebooks and HTML, live reload, multilingual support, Deployment support

The following libraries are left out in this comparison:

  • aurora - not having a nice-looking demo
  • Hyde - not maintained anymore and no Python 3 support
  • makesite - not maintained anymore

Decision

In the end, the winner for me was Nikola due to its many out-of-the box features, including the IPython Support available by default.