Note préliminaire : cette page est en constante évolution et peut comporter des sections incomplètes ou provisoires
Je recense ici tout ce qui m’est utile concernant l’installation, le peaufinage et l’utilisation au quotidien du moteur de blog statique Pelican.
À chaque réinstallation de mon ordinateur, je dois réinstaller les outils nécessaires, via apt, pip ou virtualenv. Cette documentation me permet de ne rien oublier.
Liens utiles :
Les billets du blog sur le sujet porteront le libellé pelican.
Installation
Système de base
J’installe Pelican dans un environnement virtuel en Python3 :
# Mise en place du virtualenv
sudo apt install python3-virtualenv
mkdir -p ~/.local/opt/
python3 -m venv ~/.local/opt/pelican-venv
source ~/.local/opt/pelican-venv/bin/activate
# Installation des packets nécessaires
pip install wheel # afin d'éviter les avertissements concernant ce paquet
pip install pelican markdown
Thèmes et plugins
Certains thèmes et plugins sont installable à l’aide de pip, mais la plupart ne sont disponibles que sur le dépôt Github du projet. On va donc tous les récupérer via ce moyen. Les thèmes et plugins sont disponibles sur Github. La méthode la plus simple pour y avoir accès et on va récupérer ceux qui sont nécessaires.
cd ~/.local/opt/
git clone https://github.com/getpelican/pelican-plugins
git clone https://github.com/getpelican/pelican-themes
La mise à jour des dépôts se fera ensuite avec un simple git pull lancé depuis chacun des dossiers.
Dépendances des thèmes et plugins
Le README de chaque thème et plugin précise quelles sont les dépendances à installer (toujours dans le virtualenv python). Je reprends ci-dessous ceux que j’utilise.
# Pour le plugin better_figures_and_images
pip install bs4 pillow pysvg-py3 cssutils
# Pour le thème pelican-bootstrap3
pip install typogrify
Astuces à venir :
- Paramètres particuliers dans la configuration
- Mise en place d’alias et de fonctions bash
- Modification du Makefile
Configuration
À venir : détails de la configuration
Usage au quotidien
Afin de faciliter le lancement d’une “session” d’édition d’un article du blog, j’ai créé la fonction suivante dans le fichier ~/.bash_aliases :
function pragmageek {
source $HOME/.local/opt/pelican-venv/bin/activate
nautilus $HOME/Documents/Blog/pragmageek/content &
firefox --new-tab http://localhost:8000 &
cd $HOME/Documents/Blog/pragmageek/
make devserver
}