Pour installer le projet NPM, utilisez la commande make install.
Les logiciels et bibliothèques suivantes sont nécessaires :
- Node Package Manager (installation) ;
- Make (téléchargement) ;
- Pandoc (installation).
Pour générer le site, utilisez la commande make (ou make all). Le PDF est d'abord créé dans le dossier src via Pandoc, puis les fichiers du site sont générés dans le dossier dist par Webpack.
Le site peut aussi être déployé automatiquement via Vercel.
Pour générer uniquement les fichiers du sites (tout sauf le PDF), utilisez la commande make dist.
Pour créer le PDF depuis les fichiers Markdown (src/textes) via Pandoc, utilisez la commande make pdf. Le chemin du fichier généré est src/ppi.pdf.
Le fichier sera automatiquement copié dans le dossier
distpar Webpack.
Le fichier est PDF est regénérer automatiquement à chaque poussée sur le dépôt via Github Actions (voir .github/workflows/pdf.yaml).
Pour passer en "mode développement" (rafraîchissement automatique), utilisez la commande make dev.
Le fichier PDF est régénéré avant le lancement de Webpack.