ssgp - un générateur de site statique
Se site est généré avec un simple script sous OpenBSD. Il utilise les commandes de base (find, sed, grep) et dépend de lowdown pour la conversion du format Markdown en HTML. La majorité du code provient de ssg créé par Roman Zolotarev auquel j’ai ajouté les fonctionnalités suivantes:
1. génération automatique d’un index pour chaque sujet
Un sujet est un sous-dossier du site. Une liste de sujets est définie dans l’argument $5 à ssgp.
ssgp /home/phil/www/src /home/phil/psj philippe http://philstjacques.com "diy livres ecrits techno bonsai botanique"
Un fichier .md est considéré comme un article s’il contient au minimum les tags date: YYYY-MM-DD
et title: Mon titre
dans l’entête en format YML.
2. génération d’un index global pour tous les sujets
Un fichier index est généré pour tous les sujets combinés. On peut définir le préfixe du dossier de blog avec la variable $logdir
dans main()
. Cet index global est utilisé pour générer un flux RSS.
3. gestion et création d’images miniatures pour les articles
Si image: image.jpg
est défini dans l’en-tête du fichier .md, une miniature est ajoutée dans la page index. Si l’image miniature n’existe pas, elle est crée avec ImageMagick.
4. microformats h-feed
Les pages d’index contient des tags du format h-feed et h-entry. L’outil permet de générer un fichier RSS.
5. flux RSS avec rssg
Le fichier rss.xml est généré avec une version légèrement modifiée de rssg.
Par Philippe St-Jacques