Skip to content

getpelican/pelican-themes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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