This repository contains themes for Pelican. Feel free to clone, add your own theme, and submit a pull request. It's community-managed!
These instructions assume you have already read all the Pelican documentation, have a working site, and would now like to apply a non-default theme.
First, choose a location to hold your themes. For this example, we'll use the
~/pelican-themes, but yours could be different. Clone the
pelican-themes repository to that location on your local machine:
git clone --recursive https://github.com/getpelican/pelican-themes ~/pelican-themes
Now you should have your
pelican-themes repository stored at
To use one of the themes, edit your Pelican settings file to include this line:
THEME = "/home/user/pelican-themes/theme-name"
So, for instance, to use the
mnmlist theme, you would edit your settings
file to include:
THEME = "/home/user/pelican-themes/mnmlist"
Save the changes to your settings file and then regenerate your site by using
the Makefile you should already have set up using
Themes can also be specified directly via the
parameter to the
pelican command. If you want to edit your theme, make sure
that any edits you make are made to the copy stored in
~/pelican-themes/theme-name. Any changes made to
files stored in your site's
output directory will be deleted the next
time you generate your site.