Accueil > Shell Bash > makefile, maintenance d’un site internet statique

makefile, maintenance d’un site internet statique

lundi 13 décembre 2021, par lantsei

Cet article à pour objet la création et la maintenance d’un site internet statique à partir d’un fichier Makefile. Cet exécutable convertira des fichiers, écrits au format markdown, en langage html. Une liste des pages sera aussi créée.

Vous pouvez trouver un exemple de site ainsi créé sur cette base, à cette adresse.

Installation du programme markdown. sudo apt update && sudo apt install markdown -y
Structure des fichiers bin # contient les scripts shell html # contient les pages html medias # contient les images, entre autre modeles # contient les modèles d'en tête et de pieds de pages favicon.ico index.html Makefile style.css
Fichier Makefile ## Extentions à traiter .SUFFIXES: .md .html ## Convertisseur à utiliser TOHTML = markdown ## Traitement des fichiers md à convertir en html : # "$@" correspond au fichier que l'on veut obtenir (page.html) # "$<" au fichier source (page.md) .md.html: @echo "$< -> $@" @cat modeles/en-tete.html > $@ @${TOHTML} < $< >> $@ @cat modeles/pied-de-page.html >> $@ @bin/titre.sh $@ ## Répertoire contenant les fichiers markdown sources SRCDIR = html/ ## liste d'exclusion de fichiers LIST = *.html ## Recherche des fichiers markdown # "!=" permet de remplir la variable "SRC". # find ${SRCDIR} -type f -name \*.md" permet de lister tous les fichiers "md" dans le dossier html. # "-a ! -path ${LIST}" : permet d'exclure des fichiers. # "-a ! -path ${SRCDIR}" : permet d'exclure des dossiers. # "| sort" : permet de trier la liste dans l'ordre alphabétique. SRC != find ${SRCDIR} -type f -name \*.md \ -a ! -path ${LIST} \ -a ! -path ${SRCDIR}/archive/\* \ | sort ## Variable qui contient la liste de tous les fichiers que l'on veut obtenir HTML = ${SRC:.md=.html} ## instruction pour le traitement de la liste précédente all :${HTML} ## localisation du fichier contenant la liste des pages LIST = ${SRCDIR}/index.md HTMLLIST = ${LIST:.md=.html} ## Génération de la liste ${LIST}: ${SRC} @echo "$@" @bin/liste.sh ${SRC} > $@ ## Génération de la page html all: md html md: ${LIST} html: ${HTMLLIST} ${HTML}
Création de deux fichiers html dans le répertoire modeles
- en-tete.html
  Contenant : <!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <!--<link rel="stylesheet" href="./../style.css" />-→ <!--<link rel="icon" type="image/x-icon" href="./../favicon.ico" />-→ <title> </title> </head> <body>
- pied-de-page.html
  Contenant : </body> </html>
Les srcipts shell
1. Le script bin/liste.sh
  Script permettant de générer une liste des pages html sous la forme <a href="">titre</a> dont le titre sera <h1>Liste</h1> bin/sh printf '%s\n\n' "# Liste" for l in $@ do TITLE="$(grep -m1 "#" "${l}" | sed 's/^# //')" if [ -n "${TITLE}" ]; then md="$(printf "%s" ${l} | cut -d'/' -f2- )" name="$(basename ${md} .md)" echo="$(echo "html/"${name}".html")" printf '[%s](/%s)\n\n' "${TITLE}" "${echo}" fi done
2. Le script bin/titre.sh
  Ajoute un titre après la balise <title> située dans l’entête de la page html, ligne correspondant au titre <h1> trouvé. #!/bin/sh DEFAULT=" " TITLE=" $(grep -m1 "<h1>" "${1}"| \ sed -n -e 's/.*<h1>$.*$<\/h1>.*/\1/p')" test -z "${TITLE}" && TITLE="${DEFAULT}" sed -i "/<title>/a\\ ${TITLE}" "${1}"
Rendre les fichiers de script exécutables cd var/www/bin cmod +x *
1. Lancement de l’opération de maintenance. make
Il est possible de créer un script pour lancer make sans avoir à se positionner à chaque fois dans /var/www/ #!/bin/bash /var/www/notes.lantsei/make &> /dev/null

&> /dev/null, permet l’execution en mode silencieux.
Il peut être utile de créer un script permettant de supprimer tous les fichiers html ainsi créés. ainsi que les fichiers index.md qui peuvent créer une ligne morte dans la liste. #!/bin/bash find /var/www/html/ -type f -name *.html -delete find /var/www/html/ -type f -name index.md -delete

Voir en ligne : Source