Skip to content

getpelican/pelican-themes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a46e5a7 · Jan 29, 2025
Oct 29, 2023
Jul 18, 2015
Aug 31, 2022
May 11, 2018
Sep 21, 2017
Feb 21, 2022
Mar 3, 2021
Nov 2, 2013
Apr 16, 2017
Mar 7, 2017
Mar 7, 2017
Mar 7, 2017
Dec 13, 2016
Feb 28, 2016
Apr 8, 2017
Sep 10, 2016
Oct 26, 2013
Jan 21, 2019
Jul 1, 2022
May 15, 2015
Oct 9, 2018
Mar 7, 2017
Mar 7, 2017
Mar 7, 2017
Mar 7, 2017
Sep 4, 2017
Feb 19, 2016
Mar 7, 2017
Sep 20, 2018
Mar 7, 2017
May 15, 2017
May 15, 2015
Dec 10, 2019
Mar 26, 2019
Oct 29, 2015
May 15, 2015
Oct 29, 2015
Nov 5, 2015
May 15, 2015
Mar 7, 2017
Mar 7, 2017
May 15, 2015
Aug 18, 2022
Dec 8, 2019
Mar 7, 2017
Mar 7, 2017
Oct 29, 2015
May 15, 2015
Sep 25, 2016
May 5, 2024
May 8, 2024
Jul 18, 2015
Aug 12, 2020
May 15, 2015
May 15, 2015
Oct 13, 2013
Feb 14, 2017
May 15, 2015
Oct 29, 2015
Mar 7, 2017
Jan 29, 2014
May 15, 2015
May 15, 2015
Jun 5, 2016
Oct 29, 2015
Oct 16, 2015
Apr 8, 2017
Sep 9, 2015
Oct 29, 2015
Oct 29, 2015
Dec 12, 2017
Aug 4, 2017
May 15, 2015
Oct 29, 2015
Mar 7, 2017
Jun 8, 2017
Oct 29, 2015
May 15, 2015
Feb 4, 2019
Mar 7, 2017
Mar 7, 2017
Aug 27, 2018
Aug 3, 2015
Apr 16, 2017
Jun 18, 2020
Jan 19, 2016
Nov 12, 2023
May 15, 2015
Feb 13, 2018
Aug 14, 2023
Dec 28, 2016
May 15, 2015
May 15, 2015
May 15, 2015
Mar 25, 2017
Oct 29, 2015
May 15, 2015
Mar 7, 2017
May 15, 2015
Mar 22, 2017
Oct 29, 2015
Aug 24, 2017
Nov 4, 2017
Dec 22, 2015
May 14, 2018
Nov 26, 2021
Oct 29, 2015
Mar 7, 2017
May 15, 2015
Sep 22, 2020
May 15, 2015
Mar 7, 2017
May 15, 2015
Jan 29, 2025
Aug 22, 2019
Oct 29, 2015
Mar 7, 2017
Sep 5, 2017
Feb 4, 2017
Apr 16, 2017
May 15, 2015
Sep 24, 2018
Apr 8, 2017
Jan 17, 2017
Oct 29, 2015
May 15, 2015
Mar 7, 2017
Mar 7, 2017
Oct 1, 2019
Sep 24, 2018
Jul 30, 2024
Jan 29, 2025
Jul 28, 2024
Jul 30, 2024
Jul 30, 2024

Repository files navigation

Pelican Themes

This repository contains themes for Pelican. Feel free to clone, add your own theme, and submit a pull request. It's community-managed!

A live version can be seen at http://www.pelicanthemes.com.

Using Themes

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 directory ~/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 ~/pelican-themes/.

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 pelican-quickstart:

make html

Themes can also be specified directly via the -t ~/pelican-themes/theme-name 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.

Generating Theme Previews

Generating theme previews happens automatically via a GitHub Actions workflow, after which those previews are published to https://pelicanthemes.com. If you want to generate previews locally on your workstation, clone the Pelican repository (for example, to ~/projects/pelican/), clone this repository somewhere, change to the root directory of that clone, and follow these steps:

python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~/projects/pelican/samples _pelican/
python build-theme-previews.py