Lepagito

A lovely pelican theme

Getting started

Lepagito is a lovely pelican theme.

Observe it first in action on the lepagito web site. Also, it is used by both the Pirogh author's blog, the Greuze-Cottave blog for painters and designers and the galleria pelican plugin documentation.

You're interested? Fascinated? Let's start! First, download and install the theme:

git clone https://gricad-gitlab.univ-grenoble-alpes.fr/internet/lepagito

For navigation and searches, this theme includes the optional neighbors, search and sitemap pelican plugins:

sudo apt install pelican python3-pip python3.11-venv python3-full python-is-python3
python -m venv ~/mypy
source ~/mypy/bin/activate
pip install pelican-neighbors
pip install pelican-search
pip install pelican-sitemap
pip …
Read more:

The file pelicanconf.py

Here is a complete example of the pelicanconf.py file, as used for the present documentation of the theme. It starts by setting some standard pelican variables, as usual. Then, come the theme's and the optional plugins.

# =============================
# 1. standard pelican variables
# =============================
SITEURL      = 'http://lepagito.artliba.org'
SITENAME     = 'Lepagito'
AUTHOR       = 'I. Lepage and P. Hesse'
SITESUBTITLE = 'A lovely pelican theme'
TIMEZONE     = 'Europe/Paris'
DEFAULT_LANG = 'en'
LOCALE       = 'C'

PATH         = 'content'
STATIC_PATHS = []

OUTPUT_PATH  = 'output'
#DELETE_OUTPUT_DIRECTORY = True # before site generation

DISPLAY_CATEGORIES_ON_MENU = False # choose a custom top menu here
MENUITEMS = (
  ('All',        'index.html'),
  ('Quickstart', 'quickstart.html'),
  ('Goodies',    'goodies.html'),
  ('Options',    'options.html'),
  ('#Tags',      'tags.html' …
Read more:

Article navigation

The navigation between two successive pagination of article summaries is presented at the bottom: it provides both Oldest/Newest pages and also Fist/Last, for efficiency. When reading articles, the navigation between previous and next articles is presented both at the top and the bottom. This navigation feature is implemented thanks to the pelican neighbors plugin.

By default, the oldest pages and article navigation links appear on the right, and newest on the left. The LEPAGITO_NAVIGATION_SWAP variable in the pelicanconf.py file allows to swap from left to write this navigation. This feature is useful when the chronology of a …

Read more: