Un bidouillage perso dont je devrais probablement avoir honte.
Essentiellement basé sur un Makefile, beaucoup de macros m4,1 et des scripts divers.
La plupart des pages sont écrites directement en HTML, avec les macros m4 pour insérer les boilerplates communs à toutes les pages et automatiser quelques trucs (genre une macro DOWNLOAD(file.tar.gz) qui se développe en
Quelques pages sont générés à partir d’autres sources que du HTML m4-ifié :
des fichiers texte en Markdown ou en reStructuredText ;
des documents DocBook ;
des carnets Jupyter.
La possibilité d’utiliser plusieurs formats sources indifféremment (HTML, Markdown, RST, DocBook, etc.) est une des principales raisons qui m’ont fait commettre ce bidouillage. Je n’ai pas re-vérifié depuis, mais à l’époque où j’ai commencé (il y a plus de dix ans) je n’avais pas trouvé de générateur de site statique qui permette ça, chacun ne supportait qu’un seul format source, sans mécanisme pour injecter des pages générées différemment.
1 Le manuel de m4 contient l’avertissement suivant :
Some people find m4 to be fairly addictive. They first use m4 for simple problems, then take bigger and bigger challenges, learning how to write complex sets of m4 macros along the way. Once really addicted, users pursue writing of sophisticated m4 applications even to solve simple problems, devoting more time debugging their m4 scripts than doing real work. Beware that m4 may be dangerous for the health of compulsive programmers.
J’aurais probablement dû le prendre plus au sérieux. Hélas, c’est trop tard pour moi désormais. Je témoigne pour que d’autres programmeurs ne tombent pas dans le piège. Dites non à m4 !
# Make + m4 + sh + ...
Posté par gouttegd . En réponse au journal Static Site Generator. Évalué à 7.
Un bidouillage perso dont je devrais probablement avoir honte.
Essentiellement basé sur un Makefile, beaucoup de macros m4,1 et des scripts divers.
La plupart des pages sont écrites directement en HTML, avec les macros m4 pour insérer les boilerplates communs à toutes les pages et automatiser quelques trucs (genre une macro
DOWNLOAD(file.tar.gz)qui se développe en).
Quelques pages sont générés à partir d’autres sources que du HTML m4-ifié :
La possibilité d’utiliser plusieurs formats sources indifféremment (HTML, Markdown, RST, DocBook, etc.) est une des principales raisons qui m’ont fait commettre ce bidouillage. Je n’ai pas re-vérifié depuis, mais à l’époque où j’ai commencé (il y a plus de dix ans) je n’avais pas trouvé de générateur de site statique qui permette ça, chacun ne supportait qu’un seul format source, sans mécanisme pour injecter des pages générées différemment.
1 Le manuel de m4 contient l’avertissement suivant :
J’aurais probablement dû le prendre plus au sérieux. Hélas, c’est trop tard pour moi désormais. Je témoigne pour que d’autres programmeurs ne tombent pas dans le piège. Dites non à m4 !