A simple pelican theme
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
static
templates
LICENSE
README.md

README.md

dashof

A simple pelican theme. You can see how it looks like on my website werthmuller.org.

The theme has the blog in a subdirectory (/blog), not on the main page. As of now, it truly is very simple. Many of the features from pelican are not included, such as the feed-possibilities, but also the tags-, categories-, archive-, and authors-pages. It was designed for a single author page, with a very low-volume blog, so no tagging/categorizing is required.

It is in many ways more a dirty hack than proper coding to get it to look the way I want it. (The stuff that follows now could probably be avoided by looking properly into pelican, and make adjustments were required.)

In oder to make it work, you have to adjust a few things in your pelicanconf.py:

  1. It requires to know where the blog-directory is:

    BLOGDIR = 'blog'
    
  2. Blog-directory

  3. Pelican 3.3.0: You have to insert your blog-directory into the PAGINATION_PATTERNS:

    PAGINATION_PATTERNS = (
        (1, '{base_name}/index.html', '{base_name}/blog/index.html'),
        (2, '{base_name}/index{number}.html', '{base_name}/blog/index{number}.html'),
        )
    
  4. Pelican 3.5.0: You have to insert your blog-directory into the INDEX_SAVE_AS:

    INDEX_SAVE_AS = 'blog/index.html'
    
  5. The blog-name in the static menu must agree with your BLOGDIR (the example is from my setting):

    MENUITEMS = (
           ('Blog', 'blog'),
           ('Research', 'research'),
           ('About', 'about')
           )
    
  6. The footer is defined in its own tag as a string:

    FOOTER = 'My Site ~ 2014 Example Author'
    
  7. The contact-page has an additional header, calling the validating java script. The template takes your first entry of the LINKS as your contact page. Otherwise, you have to adjust the page.html template. But then, you might want to do the contact form completely different anyway.

  8. For the inclusion of IPython notebooks, you need my modified version of the liquid_tags plugin for pelican, and provide the required parameters (I also use the neighbors plugin in the article-template):

    PLUGIN_PATH = '/path/to/your/plugins'
    PLUGINS = ['liquid_tags.notebook', 'neighbors']
    NOTEBOOK_DIR = '/path/to/your/notebooks/relative/to/blog/path'
    

The modified plugin liquid_tags will create the following files:

  • output/theme/static/css/ipynb.css
  • output/theme/static/js/collapse.js
  • output/theme/static/js/math.js

The following files are not provided by this theme itself:

  • dashof/static/css/normalize.css
  • dashof/static/css/pygment.css
  • dashof/static/js/gen_validatorv4.js

The file normalize.css is from git.io/normalize.

The file gen_validatorv4.js is from javascript-coder.com.

The file pygment.css was created with

$ pygmentize -S default -f html > dashof/static/css/pygment.css