Pelican is an open source project written in Python.
create a python3 virtual env
create a dedicated folder
mkdir pelican
cd pelican/
python3 -m venv venv
source the activation script
. ./venv/bin/activate
install pelican
python -m pip install "pelican[markdown]"
after installation, the following modules are installed :
(venv) cold [ site ]$ pip list
Package Version
--------------- -------
blinker 1.4
docutils 0.16
feedgenerator 1.9.1
Jinja2 2.11.2
Markdown 3.2.2
MarkupSafe 1.1.1
pelican 4.5.4
pip 20.3.3
Pygments 2.6.1
python-dateutil 2.8.1
pytz 2020.5
setuptools 51.1.1
six 1.15.0
smartypants 2.0.1
typogrify 2.0.7
Unidecode 1.1.2
later, you can update pelican within the virtual env using :
python -m pip install --upgrade pelican
create a subfolder for your site
mkdir site
cd site
Use the pelican quickstart script to install the defaul theme, and some configuration files
pelican-quickstart
create your first content and test it
Let's create our first article
cd content
cat > keyboard-review.md
Title: My First Review
Date: 2010-12-03 10:20
Category: Review
Following is a review of my favorite mechanical keyboard.
Generate the html files and test it locally
cd ..
pelican content
pelican --autoreload --listen
open your browser to : http://127.0.0.1:8000
et voilà !
tip and trics
Print all pelican settings :
pelican --print-settings
Install additionnal themes in :
/venv/lib/python3.9/site-packages/pelican/themes/notmyidea