Suite à une bouillante réflexion, j’ai finalement pris la décision brillante d’exploiter mon site pour y partager toutes mes expériences excentriques. J’ai bon espoir que les plus audacieux d’entre vous seront ravis de découvrir toutes les informations et astuces que je partage ici à la sueur de mon front 😁

Pourquoi et pour quoi ?

Transformer mon site, qui, jusqu’à présent, assurait la simple fonction de “point d’accueil de mon nom de domaine parce qu’il en faut bien un” en quelque chose de plus pertinent.

Écrire mes expériences de vie, apportera, je l’espère, plusieurs avantages. Les passionnés comme moi ont tous secrètement cette envie de partage, mais c’est autre chose de se lancer.

Sur ce blog, pas de thème précis, j’aborderai tout sujet et thématique selon mon humeur délirante du moment, sous la seule condition que le contenu sera en mesure de créer une frénésie de passion sans précédent auprès d’une foule en délire qui ne manquera pas de s’abonner au Flux RSS .

Salut Pelican

C’est donc naturellement que je vais commencer à vous parler du choix de l’outil que j’utilise pour me lancer dans cette aventure : Pelican

Cet outil est absolument parfait pour les dingos exigeants comme moi, ce moteur Python ultra léger permet de générer un site statique à partir de vos fichiers Markdown ou reStructuredText.

Aucune base de données ni moteur web requis, il suffit de lancer la moulinette et Pelican va vous recracher fissa un site web statique complet (HTML, CSS, JS).

Cette note est la première que je fais suite à une installation et configuration de mon instance Pelican et c’est clairement très efficace, car l’outil n’en reste pas moins puissant et offre un large choix de fonctions (Gestion de thème, extension, Flux RSS, publications multi-langue, etc … ), et surtout tout est à plat et versionné sur mon git, et la personnalisation est possible sans contrainte.

C’est auto-hébergeable, libre et documenté, bref rien à redire, c’est le pied, fais tourner c’est de la bonne.

Merci à mon tout-puissant Sensei Ephase pour m’avoir inspiré et aidé à découvrir cet outil 😎

Faire connaissance avec le piaf

Une fois votre serveur web prêt, il vous faudra installer quelques nécessités : Python avec virtualenv, pip et make.

Pour les modules pip, voici une liste de quelques dépendances que j’utilise :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

blinker
commonmark
docutils
feedgenerator
invoke
Jinja2
livereload
Markdown
markdown-it-py
MarkupSafe
mdurl
pelican
Pygments
python-dateutil
pytz
rich
six
smartypants
tornado
typogrify
Unidecode
beautifulsoup4
html2text
requests
black

Installation et configuration

Allons-y Alonso ! ✊

1
2
3
4
5
6
7
8

# Activation du virtualenv Python
virtualenv ~/virtualenvs/pelican
cd ~/virtualenvs/pelican
source bin/activate

# Installation de Pelican dans votre dossier d'hébergement web
cd /var/www/html/
pip3 install -r requirements.txt

Puis il suffit de se laisser guider pour la configuration :

1

pelican-quickstart

Vient alors le choix du thème (j’ai personnellement opté pour Pelican-Alchemy ✨ pour le moment) et des extensions. Puis finalement, il faut passer du temps à personnaliser les fichiers de configuration .py, ajouter votre contenu dans le dossier content et faire pointer votre serveur web sur le dossier output qui contient votre site statique généré.

1
2
3
4
5
6
7
8

/
├── content
│   └── (pages)
├── output
├── tasks.py
├── Makefile
├── pelicanconf.py       # Main settings file
└── publishconf.py       # Settings to use when ready to publish

Exemple d’utilisation

Pour exemple, voici à quoi ressemble le fichier Markdown de cet article :

1
2
3
4
5
6
7
8

Title: Lancement de mon blog
Cover: assets/bg_pelican.jpg
Category: Informatique
Tags: pelican, python, autohébergement, web, blog
Date: 2023-08-01 0:00
Status: published

Blah blah ... et ils trépignèrent à la lecture de cette note ... blah blah !

Un pti coup de moulinette :

1

make publish

Et vouualaaa ! 👌

Vous avez les bases, la documentation de Pelican vous permettra d’aller plus loin ensuite.

À bientôt pour de nouvelles aventures !