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.
Georg Krause 505be9315e
Open header links in new tabs
2 years ago
alchemy Open header links in new tabs 2 years ago
docs Support for link posts through the Link: metadata field 3 years ago
screenshots Update screenshot for old style 3 years ago
.gitignore Enable installation with pip 4 years ago Refresh code of conduct 6 years ago
LICENSE Add missing copyright year 6 years ago Enable installation with pip 4 years ago Allow overriding bundled FontAwesome CSS with CDN URL 3 years ago Enable installation with pip 4 years ago

Pelican Alchemy

A magical Pelican theme

Alchemy is a functional, clean, responsive theme for the Pelican static site generator.

Inspired by crowsfoot and clean-blog, it features:

** Features link to external assets (webfonts etc).


Default colors

Old style (see below)

Sketchy (Boostwatch)

Solar (Boostwatch)

United (Boostwatch)

To enable old visual style add THEME_CSS_OVERRIDES = ['theme/css/oldstyle.css'] to your and use no Boostwatch themes. See stylesheet for more information.


From Git repo

Clone the repo:

git clone

Set the THEME variable in your Pelican config:

THEME = '<PATH_TO_REPO>/alchemy'

As a Submodule

In your Pelican site:

mkdir themes
git submodule add themes/pelican-alchemy

And in Pelican config:

THEME = 'themes/pelican-alchemy/alchemy'

With pip

Alternatively, you can install this theme with pip:

pip install ""

And import it from Pelican config:

import alchemy
THEME = alchemy.path()


Visit the Settings docs for examples:

  • SITESUBTITLE: Subtitle that appears in the header.
  • SITEIMAGE: Image that appears in the header.
  • DESCRIPTION: Index HTML head <meta> description.
  • LINKS: A list of tuples (Title, URL) for menu links.
  • ICONS: A list of tuples (Icon, URL) for icon links. Icons are assumed to be Font Awesome brand icons, if you need to use icons from other Font Awesome icon set please provide full CSS class, e.g. fas fa-camera instead on just camera
  • FOOTER_LINKS: A list of tuples (Title, URL) for footer links. Replaces default set of links (Authors, Archives, Categories, Tags).
  • BOOTSTRAP_CSS: URL of Bootstrap CSS file. Use this to enable Boostwatch themes.
  • FONTAWESOME_CSS: URL of Font Awesome CSS file. Use this if you wish to use CDN provided version instead of the bundled one.
  • PYGMENTS_STYLE: Built-in Pygments style for syntax highlighting.
  • HIDE_AUTHORS: Hide the author(s) of an article - useful for single author sites.
  • RFG_FAVICONS: Use a Favicon Generator package.
  • THEME_CSS_OVERRIDES: Sequence of stylesheet URLs to override CSS provided by theme. Both relative and absolute URLs are supported.
  • THEME_JS_OVERRIDES: Sequence of JavaScript URLs to enable with this theme. Alchemy uses no JS by default. Both relative and absolute URLs are supported.

Misc settings:


Example (demo website).

Tips & Tricks

See documentation page

How to Contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  3. Send a pull request and bug the maintainer until it gets merged and published. :)

Alchemy follows the Contributor Covenant code of conduct.


MIT © 2017 Nairobi GNU/Linux Users Group