Seafoam 2.0.4 Pelican Theme Released

Version 2.0.4 of Seafoam has been released.

Seafoam is the Pelican theme I use for this site, but published to PyPI in the hope that it will be useful to others.

This release changes the name of the project to seafoam from the unwieldy minchin.pelican.themes.minchindotca. It also add support for the Pelican Comment System, removes the need to define Jinja2 filters in your configuration file, updates to Font Awesome v4.7, and several design fixes as well. Code is updated to work with Pelican v3.7 and Jinja v2.9.


To use this theme, first install it via pip: (as a side, this is the only Pelican theme I know of that is installable from PyPI.)

pip install seafoam

Next, update your to use the theme, with its default settings:

import seafoam

THEME = seafoam.get_path()

PLUGINS = ['minchin.pelican.jinja_filters',
           # others, as desired...

  'article-feature': ["scale_in 848 848 True"],
  'index-feature': ["scale_in 263 263 True"],

And then regenerate your site.

The theme depends on the pathlib library, that was introduced in Python 3.4, so the theme won’t work on earlier versions of Python. Installing the pathlib2 library should provide the necessary functionality for the theme to work, but this is currently untested by me.


The full settings are not particularly well documented (by me anyway), although the the ReadMe for the base theme goes over most of the settings.


I’ve built a release script that automates pushing releases to PyPI, and so it makes it very easy to make a release. In fact, writing these release blog posts is probably the most involved part of cutting a release! Therefore, this blog post is to serve for five releases: 2.0.0, 2.0.1, 2.0.2, 2.0.3, and 2.0.4:

Version 2.0.0 — January 9, 2017

  • BREAKING: rename from minchin.pelican.themes.minchindotca to seafoam
  • feature: add support for Pelican Blog System
  • feature: add Seafoam logo
  • feature: switch to minchin.pelican.jinja_filters to provide the required Jinja filters, rather than requiring them to be manually added to the user’s configuration file
  • feature: upgrade to FontAwesome 4.7.0
  • feature: upgrade to jQuery 3.1.0
  • feature: add support for reading time via post stats plugin
  • feature: add support for pelican comment system
  • bug: restyle comments with bootstrap’s media class (much cleaner template code) (see issue 6)
  • bug: switch template variable from PAGES to pages to support Pelican v3.7 (see issue 5)
  • bug: don’t print section for next and previous posts in a category if the article is the only one in that category

Version 2.0.1 — January 10, 2017

  • bug: pluralization of “1 comment” now correct (see issue 8)
  • bug: fix pagination code to work with Jinja2 v2.9.0 (see issue 9)

Version 2.0.2 — January 11, 2017

  • bug: fix link color on panel-primary
  • bug: improve layout of generated HTML

Version 2.0.3 — January 11, 2017

  • bug: fix link color in body area of panel-primary (fixes regression from version 2.0.2)

Version 2.0.4 — January 11, 2017

  • bug: fix archive page template code to work with Jinja2 v2.9.0 (see issue 10)

Other posts

Other posts under Seafoam


There are no comments yet. Will you add the first one?

Add a Comment

You can use the Markdown syntax to format your comment.

or alternately, send me your thoughts at minchinweb [at]

Comment Atom Feed (for this post)