www.bernatchez.net

Pelican est un générateur de sites web statiques. C'est l'outil que nous utilisons pour maintenir nos sites statiques.

Ce document suppose que nous utilisons venvwrapper [1].

Installation de Pelican

Effectuez cette opération dans notre environnement virtuel Python. Nous avons nommé notre environnement statsites.

Activez-le et installez Pelican.

venv statsites
pip install pelican

Thèmes

Dans chacune de nos configurations pelicanconf.py, nous sélectionnons un thème pour le site concerné. Pour obtenir une sélection de thèmes, nous avons cloné comme suit:

git clone --recursive https://github.com/getpelican/pelican-themes ${HOME}/pelican-themes

Note sur le thème du site

Sur nos propres sites, nous avons apporté quelques ajustements au thème lightweight pour l'adapter à nos besoins.

Nous maintenons ce thème dérivé de lightweight et notre contenu web dans notre dépôt de contrôle de version Git. Notre fichier de configuration pelicanconf-en.py contient cette référence ci dessous.

THEME = u"/home/ubuntu/allrepos/mystatic_sites/derived-themes/lightweight-single-home-en"

Le thème de votre site sera à vous de choisir et/ou de modifier.

Initialiser le système de fichiers du site squelettique

Utilisez pelican-quickstart pour générer le contenu statique initial du site web avec Pelican.

pelican-quickstart crée un système de fichiers de génération de site squelette sous le répertoire vide actuel.

Créez ensuite des fichiers .rst dans les répertoires content/n_importe_quel_nom comme articles de blog. Créez des fichiers .rst dans content/pages comme pages de blog.

Compilation

Générez les fichiers du site web une fois tous nos fichiers sources .rst disponibles. Pour cela, il suffit d'utiliser le Makefile. La procédure suivante compilera et diffusera tout le contenu du site web sous output/ en utilisant Pelican.

make html

Vous pouvez voir vos résultats en appelant le fichier output/index.html.