pneumatic

Minimalistic, responsive Pelican theme.

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:
  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>

Screenshots

Index Page Article

License

Pneumatic is licensed under the MIT License.

Related Repositories

pneumatic

pneumatic

pneumatic is a bulk-upload library for DocumentCloud. ...

pneumatic

pneumatic

Minimalistic, responsive Pelican theme. ...

pneumatic-tubes

pneumatic-tubes

WebSocket based transport of events between re-frame app and server ...

Pneumatic

Pneumatic

Pneumatic base code ...


Top Contributors

iKevinY