Pneumatic

Pneumatic is a minimalistic, responsive Pelican theme inspired by a design by Greg Reda. The name was chosen because it is based on the Skeleton framework, and pelicans (like most birds) possess skeletal pneumaticity. Visit kevinyap.ca to see Pneumatic in action.

Requirements

Pneumatic requires Sass and two Pelican plugins: Neighbours and Assets.

Configuration

• Create a directory containing all of the relevant icons. Set ICONS_PATH to that directory's path (ex. images/icons) and ensure that it has been added to STATIC_PATHS.

• There are intentionally no author, category, and tag page templates, so AUTHORS_SAVE_AS, CATEGORY_SAVE_AS, CATEGORIES_SAVE_AS, and TAGS_SAVE_AS should all be set to ''.

• pygments.css can be modified to change the code block colour scheme.

• Some font and colour choices can be customized in pneumatic.scss.

• CodeHilite line numbers should be enabled in Pelican's configuration file:

  # Pelican 3.7+
  MARKDOWN = {
      'extension_configs': {
          'markdown.extensions.codehilite': {'linenums': True}
      }
  }
  
  # Pelican 3.6 and older
  MD_EXTENSIONS = ['codehilite(linenums=True)']

Here are theme-specific settings that should be present in the Pelican configuration file:

Setting	Description
SITENAME	Text displayed under avatar in sidebar
BIO_TEXT	Text displayed under site name
FOOTER_TEXT	Text displayed in site footer
ICONS_PATH	Location of site icons (ex. images/icons)
SITE_AUTHOR	Used for author <meta>
TWITTER_USERNAME	Used for Twitter Cards <meta>
GOOGLE_PLUS_URL	Used for Google+ <meta>
INDEX_DESCRIPTION	Used for description <meta> on index page
SIDEBAR_LINKS	List of anchor elements to be displayed under bio text
GOOGLE_FONTS	List of fonts to import from Google Fonts
SOCIAL_ICONS	List of tuples in the form (link, title, icon-class)
THEME_COLOR	Primary colour of the site (ex. #000000)
DISQUS_SITENAME	Disqus shortname (optional)
GOOGLE_ANALYTICS	Google Analytics tracking code (optional)
DOMAIN	Used for Google Analytics and Twitter Cards <meta>
FA_EMBED_CODE	Font Awesome CDN embed code (optional)

Screenshots

License

Pneumatic is licensed under the MIT License.