pelican-theme-bootstrap3

Bootstrap 3 based theme for Pelican. Used on my blog - feel free to copy and adjust. Texts are English.

Usage

Download the latest release, extract and put the bootstrap3 folder somewhere and point the THEME setting in your pelicanconf.py to this place. For example:

# THEME = '/home/me/pelican/bootstrap3/'

Also configure the Jinja2 extension "with":

# JINJAEXTENSIONS = ['jinja2.ext.with']

Code highlighting

Pelican comes with pygments for syntax highlighting. I do not want to always include the pygments css files, so it is only included if a post has the tag code (works on all pages).

Plugin usage

Theme uses the following plugins:

• Related posts, displayed only on detail pages
• tag_cloud, displayed on the right of each page

For configuration see next chapter.

Configuration

There are some minor configurations available (set within pelicanconf.py):

• COPYRIGHT: will display the set text on the page bottom, useful for a copyright info
• DISQUS_ID: if set to a value, will include Disqus comment code
• EXCLUDE_TAGS_FROM_TAGCLOUD: list of tag names that shall not be included in the tag cloud. E.g. you might find it useful to exclude the "code" tag (see Code highlighting).
• PLUGIN_PATHS: add the path to the pelican plugins checkout, see pelican-plugins how to set up correctly
• PLUGINS: add the plugins tag_cloud (since Pelican 3.6) and related_posts to the list
  • PLUGINS = ['tag_cloud', 'related_posts']

Release log

• 0.4.0
  • support for Pelican 4 (#7)
  • added pin icon to article if pin_to_top extension is used and article is pinned (#2)
  • use CDN version of bootstrap instead old, static bundled one (#6)
  • fixed link in header (#4)
  • fixed listing of pages in sidebar
• 0.3.0
  • added display of modification date of content
• 0.2.1
  • fixed wrong link to pygments stylesheet
• 0.2.0
  • added categories to navigation
  • added MENUITEMS to navigation
• 0.1.0
  • initial release