Aller au contenu

Installation de Pelican (générateur de site statique)

1. Créer un environnement virtuel Python

Dans le dossier de travail choisi :

python3 -m venv venv-pelican

Activer l'environnement :

source venv-pelican/bin/activate
(Il faut réactiver l'environnement à chaque nouvelle session de terminal, avant de travailler sur le blog.)

2. Installer Pelican

pip install pelican[markdown]

Le suffixe [markdown] ajoute le support du Markdown, en plus du reStructuredText pris en charge par défaut.

3. Vérifier l'installation

pelican --version

4. Créer un site (assistant interactif, optionnel)

pelican-quickstart
Cette commande pose quelques questions (titre du site, auteur, langue, URL...) et génère automatiquement l'arborescence de base ainsi qu'un Makefile.

5. Rédiger un article

Dans le dossier content/, créer un fichier Markdown avec un en- tête de métadonnées, par exemple content/mon-article.md :

Title: Mon article
Date: 2026-08-28 10:00
Category: Général
Tags: pelican, test
Slug: mon-article
Summary: Résumé court de l'article.
Contenu de l'article ici, en Markdown.

6. Générer le site

pelican content -o output -s pelicanconf.py
Le site HTML généré se trouve alors dans le dossier output/.

7. Prévisualiser localement

pelican --listen
Le site est alors consultable dans un navigateur à l'adresse http://localhost:8000.

Bon à savoir

  • Pelican est un générateur statique : les pages HTML sont figées, sans base de données. Aucun système de commentaires n'est intégré nativement (un service tiers comme Giscus serait nécessaire pour cela, si le besoin se présentait un jour).
  • Deux fichiers de configuration distincts sont utiles :
  • pelicanconf.py pour les tests locaux ;
  • publishconf.py pour la mise en ligne définitive (avec la vraie URL du site).