pelican-yasvbtle is a responsive theme for Pelican
HTML CSS Makefile
Pull request Compare This branch is 41 commits ahead, 105 commits behind pR0Ps:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
static
templates
.gitignore
LICENSE
Makefile
README.md

README.md

Yet Another Svbtle-Inspired Pelican Theme

pelican-yasvbtle is yet another responsive, svbtle-inspired theme for Pelican. It was forked from Carey Metcalfe's pelican-subtle, which was in turn based on Giulio Fidente's pelican-svbhack theme.

I do not intend on making any significant cosmetic changes to pelican-subtle (it's almost exactly what I was looking for in a theme!), so changes made in this repository are unlikely to be of any interest to anyone aside from myself. Credit for this theme should go to Carey Metcalfe and Giulio Fidente.

Demo

You can see the theme in action on my site, Carey Metcalfe's site for pelican-subtle, and Giulio Fidente's site for pelican-svbhack.

Features

  • Clean, responsive design
  • Profile image and tagline
  • Syntax highlighting for pre blocks
  • Google Analytics (new Unified Analytics)
  • Google Authorship
  • Supports displaying a custom list of links with icons in the sidebar
  • Global keyword support

Installing

Clone the repository, edit your pelicanconf.py and modify the THEME variable to point to the downloaded theme location.

pelicanconf.py

When developing locally, you may want to set SITEURL to somrething like http://localhost:8000

This theme supports a number of custom variables:

  • GOOGLE_ANALYTICS_ID: Your Google Analytics UA-XXXXXXXX-X code (None to disable analytics).
  • GOOGLE_ANALYTICS_PROP: Your Google Analytics property name (None to disable analytics).
  • GOOGLE_PLUS_URL: A link to your Google+ profile. Used for the Google Authorship feature.
  • USER_LOGO_URL: The image to display as the profile image. Can be local or a remote URL.
  • DISQUS_SITENAME: Set this to enable Disqus comments on articles.
  • TAGLINE: The site's tagline. Rendered right below the image.
  • SCROLL_TO_CONTENT: If this is set to True, when content is below the sidebar (for example, on mobile), the page will be scrolled down to the content when it loads. An exception is made for the home page.
  • FORCE_PIXELS: Some screens (mostly mobiles) don't use pixels directly and scale based on the concept of a 'display pixel'. Setting this to True tells the device to use actual pixels. Enable with care.
  • MANGLE_EMAILS: If enabled, any emails in the SOCIAL links will be obfuscated in HTML and have their links generated by Javascript when the page loads.
  • GLOBAL_KEYWORDS: A list of strings that will be set as keywords for each page.
  • SERVER_LESS: If True, static/css/style.css will be used as the style (compile it server-side). Otherwise static/css/style.less will be compiled client-side with less.js.

Authors

pelican-subtle is authored by pR0Ps.

pelican-svbhack is authored by Giulio Fidente.

Licence

Released under MIT License, full details in LICENSE file.