Pelican theme
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Charles Reid 2483dcb020 re-init commit 3 years ago
sass re-init commit 3 years ago
static re-init commit 3 years ago
templates re-init commit 3 years ago
LICENSE re-init commit 3 years ago re-init commit 3 years ago re-init commit 3 years ago
config.rb re-init commit 3 years ago


The scurvy knave is a pelican theme for a one-off one-page site.

Source code (main repo):

Source code (backup repo):

Also see how-do-i-pelican.

Pelican is designed for 1 file -> 1 page, so assembling a single-page site from different files is difficult.

Instead, we define a fixed layout for the site, and everything is configured by the user using variables in

Unlike most pelican sites, the content/ folder will remain completely empty, and all site content will be defined in the theme and configured in the


This repo has three disparate branches:

  • master - the branch you are looking at now. This contains the files for the actual theme.
  • source - a branch containing a working pelican site that uses this theme. used to generate gh-pages branch.
  • gh-pages - a branch containing static HTML content to be served up via Github Pages

The gh-pages branch can be viewed live at


To install:

git clone

pelican-themes -i scurvy-knave-theme   # install theme

pelican-themes -U scurvy-knave-theme   # update theme

pelican-themes -r scurvy-knave-theme   # remove theme


First, set the theme in pelican.conf.

Section 1: title/subtitle

Set the site title and subtitle (description):


SITE_DESCRIPTION = "a subdomain for charlesreid1 bots"

Section 2: about

Set the title and contents of the about section:

ABOUT_TITLE = "about"

<p>Your html goes <a href="">here</a>.</p>

Because these variables are being defined in Python, this allows you to hook in any number of methods for generating HTML for your pages.

The links section has three parts: the title, the description, and the buttons.

Set the following variables:

LINKS_TITLE = "links on"

<p>HTML goes here</p>
<a href="" class="btn btn-circle btn-lg">
    <i class="fa fa-key animated"></i>     

<a href="" class="btn btn-default">example 1</a>
<a href="" class="btn btn-default">example 2</a>


This one-pager is basically all black and white, except for color provided by buttons, links, and background photographs.

The file custom.css in the scurvy-knave-theme templates provides a templated CSS file that can be used to customize the colors/styles in the theme.

First, set style-related variables.

You can define as many style variables as you want, and as long as there is a corresponding variable in custom.css, these will give you full control over the CSS on the page:

H1_COLOR = "#F00"
H2_COLOR = "#00F"


Next, we have to tell pelican to actually copy the templated CSS file to the final HTML folder (we don't have to do this with HTML because HTML files are copied over by default):

    'custom.css' : 'custom.css'

Now, when you run pelican content, it will pick up the theme, set the CSS theme variables, apply them to the CSS template file, and copy the final CSS file along with the rest of the HTML files into output/.

Custom Colors

This theme currrently defines three custom colors:

  • H1COLOR - color of title text
  • ACOLOR - color of links and buttons
  • AHOVERCOLOR - color of links and buttons when hovering over them

Useful Color Schema

Twitter blue:

ACOLOR      = "#00aced"
AHOVERCOLOR = "#0084b4"
BRIGHTCOLOR = "#1dcaff"

Nginx green:

ACOLOR      = "#aced00"
AHOVERCOLOR = "#84b400"
BRIGHTCOLOR = "#caf1d"

Perky magenta:

ACOLOR      = "#ed00ac"
AHOVERCOLOR = "#b40084"
BRIGHTCOLOR = "#ff1dca"

Seafoam green:

ACOLOR      = "#00edac"
AHOVERCOLOR = "#00b484"
BRIGHTCOLOR = "#1df1ca"

Sunflower yellow:

ACOLOR      = "#edac00"
AHOVERCOLOR = "#b48400"
BRIGHTCOLOR = "#f1ca1d"

Purple mountains' majesty:

ACOLOR      = "#ac00ed"
AHOVERCOLOR = "#8400b4"
BRIGHTCOLOR = "#ca1df1"