Ce référentiel contient des thèmes pour Pelican. N'hésitez pas à cloner, à ajouter votre propre thème et à soumettre une pull request. C'est géré par la communauté !
Une version live peut être consultée sur http://www.pelicanthemes.com.
Ces instructions supposent que vous avez déjà lu toute la documentation Pelican, que vous disposez d'un site fonctionnel et que vous souhaitez maintenant appliquer un thème autre que celui par défaut.
Tout d’abord, choisissez un emplacement pour conserver vos thèmes. Pour cet exemple, nous utiliserons le répertoire ~/pelican-themes
, mais le vôtre pourrait être différent. Clonez le référentiel pelican-themes
à cet emplacement sur votre ordinateur local :
git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes
Vous devriez maintenant avoir votre référentiel pelican-themes
stocké dans ~/pelican-themes/
.
Pour utiliser l'un des thèmes, modifiez votre fichier de paramètres Pelican pour inclure cette ligne :
THEME = "/home/user/pelican-themes/theme-name"
Ainsi, par exemple, pour utiliser le thème mnmlist
, vous devez modifier votre fichier de paramètres pour inclure :
THEME = "/home/user/pelican-themes/mnmlist"
Enregistrez les modifications dans votre fichier de paramètres puis régénérez votre site en utilisant le Makefile que vous auriez déjà dû configurer à l'aide de pelican-quickstart
:
make html
Les thèmes peuvent également être spécifiés directement via le paramètre -t ~/pelican-themes/theme-name
de la commande pelican
. Si vous souhaitez modifier votre thème, assurez-vous que toutes les modifications que vous apportez sont apportées à la copie stockée dans ~/pelican-themes/theme-name
. Toutes les modifications apportées aux fichiers stockés dans le répertoire output
de votre site seront supprimées la prochaine fois que vous générerez votre site.
La génération d'aperçus de thème s'effectue automatiquement via un workflow GitHub Actions, après quoi ces aperçus sont publiés sur https://pelicanthemes.com. Si vous souhaitez générer des aperçus localement sur votre poste de travail, clonez le référentiel Pelican (par exemple, dans ~/projects/pelican/), clonez ce référentiel quelque part, accédez au répertoire racine de ce clone et suivez ces étapes :
python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py