chirpy image+lqip

chirpy image+lqip

Notes

Le LQIP (Low Quality Image Placeholder) est une miniature très légère affichée en attendant le chargement de la vraie image. Chirpy le gère nativement, vous n’avez rien à installer côté thème : il faut seulement fournir l’image miniature et la déclarer.

Image Path Lqip

Convertir des images de taille 1200x630 en data base64

Speed Up Any Jekyll Site (Including Chirpy) Using Fast-Loading Images With LQIP and WebP

Outil imagemagick doit être installé

Convertir une image au format webp

La forme la plus simple d’utilisation est d’utiliser des options minimales

1
2
3
4
# syntaxe:
magick src.png -quality 50 -define webp:lossless=true out.webp
# exemple
magick yannick-dom1200x630.png -quality 50 -define webp:lossless=true yannick-dom1200x630.webp

Explication:

  • magick = commande shorthand à exécuter
  • src.png = l’image que nous voulons convertir
  • -quality = ici on entre la qualité de l’image de sortie, garder à 50
  • -define = ceci est pour définir quelques options supplémentaires, par exemple sans perte (lossless)
  • out.webp = le fichier webp de sortie final

Générer le LQIP

La commande suivante redimensionne l’image en petite taille, réduit sa qualité, la convertit au format WebP, l’encode en base64, puis nettoie le fichier temporaire :

1
2
3
magick yannick-dom1200x630.webp -resize 20x20 -strip -quality 20 tmp.webp && \
base64 -i tmp.webp && \
rm tmp.webp

Cette configuration permet d’atteindre un équilibre optimal entre la longueur de la chaîne de base64 et la qualité de l’image, garantissant ainsi un support de place efficace sans perte inutile de taille ou de qualité:

  • magick yannick-dom1200x630.webp: Utilise l’image WebP originale comme entrée.
  • -resize 20x20: Redimensionner l’image en 20x20 pixels, ce qui assure un bon équilibre entre le détail et la taille du fichier.
  • -strip : supprime toutes les métadonnées pour réduire la taille du fichier.
  • -quality 20: Définit la qualité WebP à 20, équilibre la fidélité visuelle et la taille du fichier.
  • tmp.webp: Crée un fichier WebP temporaire.
  • base64 tmp.webp: Convertit le fichier temporaire en une chaîne base64.
  • rm tmp.webp: Supprime le fichier temporaire après encodage.

Cette approche maintient le format WebP tout au long du processus, assurant la cohérence avec votre format d’image principal et offrant potentiellement une meilleure compression pour le détenteur de place.

La sortie base64 sera affichée dans votre terminal. Assurez-vous de copier cette sortie pour utilisation dans la prochaine étape. Si le résultat n’est pas satisfaisant, vous pouvez ajuster la taille (par exemple, 15x15 à 25x25) ou la qualité (par exemple, 15 à 30) pour trouver l’équilibre optimal pour vos images spécifiques.

Générer LQIP en utilisant Base64 file converter

Créer fichier webp temporaire

1
magick yannick-dom1200x630.webp -resize 20x20 -strip -quality 20 tmp.webp

Utiliser l’outil Base64 file converter
Le résultat, sur une seule ligne, est à copier directement sur le Font Matter après le tag lqip:

1
data:image/webp;base64,UklGRk4BAABXRUJQVlA4WAoAAAAQAAAAEwAACQAAQUxQSKkAAAABgGRt2/HmiW3btjW1k6HtpBh17i7A3EIX0O39X/cQERMAsMVCQKDjAADTJwRVHvdxWL3rPKAa1Z5iBKbNrHI5DDImU1f2pz0EKDNup7KWojO5Xn86xaCIXe+XCeWpBQY7ZrHqaJTix8v1j9Wqn5xJ5TweD1SO2qrTMGjwhNh8BoNO6I82w7tUBMdp6lECImO8WVWmDpf877d6pfvH5pJwBEyG9OJQ6GgIAFZQOCB+AAAAUAQAnQEqFAAKAD85hLlTryilorAIAeAnCWoAnR/AAoWIgsMhgvHjMkszgAD4pPC5nFIi+fikaBfTmQlqjehGSIup7btnCqiGvqCy3vBNFgg1LjVlcDl6hCN/KBH0fNTcGuNGNrOdvZIWViYqaIvVhDNbh+hK78KPt1iCKOAA

Front matter

1
2
3
4
image: 
  path: /assets/img/headers/yannick-dom1200x630.png
  lqip: data:image/webp;base64,UklGRk4BAABXRUJQVlA4WAoA...8KPt1iCKOAA
---

Ajouter LQIP au Front Matter

Après avoir généré la chaîne de base64, vous devez la copier et l’ajouter à la matière première de votre post Jekyll. Voici un exemple de la façon de l’inclure :

1
2
3
4
5
6
7
8
9
10
---
title: Maddy Mail Server mx1.xoyize.xyz 
toc: true  
date: 2025-09-03
categories: [VPS, Contabo]
tags: [messagerie]
image: 
  path: /assets/img/headers/yannick-dom1200x630.png
  lqip: data:image/webp;base64,VOTRE_CHAINE_BASE64_ICI
---

Remplacer VOTRE_CHAINE_BASE64_ICI par la chaîne de base64 que vous avez générée.

Le préfixe data:image/webp;base64, est crucial. Il indique au navigateur qu’il s’agit d’une image WebP codée en base64. Ce préfixe correspond au format WebP que nous avons utilisé lors de la génération LQIP. Si vous décidez d’utiliser un format d’image différent à l’avenir, n’oubliez pas d’ajuster ce préfixe en conséquence (par exemple, data:image/png;base64, pour PNG ou data:image/jpeg;base64, pour JPEG).

1
2
3
image: 
  path: /images/yannick-dom1200x630.png
  lqip: data:image/webp;base64,UklGRjgAAABXRUJQVlA4ICwAAACwAgCdASoUAAoAPzmGuVOvKSWisAgB4CcJaQAAeyAA/u1SHtfYWPqpYgAAAA==

Conversion dimension png

Dans Chirpy, le cadre de l’image d’aperçu a un ratio fixe de 40/21 (soit 1200x630). Avec ImageMagick, -resize 1200x630 conserve le ratio d’origine : l’image tient dans 1200x630 sans forcément les atteindre (par exemple 1200x800 devient 945x630). Selon la source, il y a donc un décalage avec le cadre. L’orientation EXIF (photo prise en portrait) peut aussi fausser le résultat.

Vérifier les dimensions réelles

1
identify -format "%f %wx%h\n" *.jpg | grep -v " 1200x630$"

Cela liste uniquement les images qui ne font pas exactement 1200x630.

Rogner

Redimensionner en remplissant le cadre (recadrage centré)

1
magick image.jpg -auto-orient -resize 1200x630^ -gravity center -extent 1200x630 image_ok.jpg

(avec convert à la place de magick si vous êtes sur ImageMagick 6). Le ^ agrandit/réduit jusqu’à couvrir tout le cadre, puis -extent recadre au centre.

NE PAS Rogner

Si vous préférez ne rien rogner

1
magick image.jpg -auto-orient -resize 1200x630 -background black -gravity center -extent 1200x630 image_ok.jpg

Cela ajoute des bandes (remplacez black par une autre couleur si besoin).

Si les dimensions sont bien 1200x630 et que le problème persiste, dites-moi où il apparaît (page d’accueil, en-tête du post, ou image dans le corps de l’article) et si l’image est vraiment en image: dans le front matter. Un LQIP ou un width/height dans le front matter peut aussi jouer. (avec convert à la place de magick si vous êtes sur ImageMagick 6). Le ^ agrandit/réduit jusqu’à couvrir tout le cadre, puis -extent recadre au centre.

1
2
3
magick Configuration_Nginx_HTTP2_HTTP3.png -auto-orient -resize 1200x630^ -gravity center \
  -background white -alpha remove -alpha off -extent 1200x630 -strip \
  Configuration_Nginx_HTTP2_HTTP3_1200x630.png

sans rien rogner

1
magick image.jpg -auto-orient -resize 1200x630 -background black -gravity center -extent 1200x630 image_ok.jpg

Fond transparent, il suffit de mettre -background none (ou transparent) et de ne pas supprimer le canal alpha.

1
2
3
magick Configuration_Nginx_HTTP2_HTTP3.png -auto-orient -resize 1200x630 \
  -background none -gravity center -extent 1200x630 -strip \
  Configuration_Nginx_HTTP2_HTTP3_1200x630.png

Par rapport à l’option 2 vue plus haut, on retire -alpha remove -alpha off, qui servaient justement à remplir la transparence en blanc.

Ce qu’il faut savoir

  • Les bandes laissent voir le fond de la page : blanc en thème clair, sombre en thème sombre. Si votre schéma a un fond blanc opaque, il restera blanc au milieu et sera entouré de bandes sombres en thème sombre, ce qui peut paraître étrange. Dans ce cas, des bandes de la couleur de fond du schéma sont plus propres.
  • Si l’image d’origine n’a pas de transparence, seules les bandes seront transparentes, ce qui convient très bien.
  • Le LQIP (si vous en utilisez un) est généré à partir de l’image et ne gère pas toujours bien la transparence : le flou initial peut sembler noir ou décalé avant le chargement complet.

Vérifier que la transparence est bien présente

1
identify -format "%f %wx%h %A\n" Configuration_Nginx_HTTP2_HTTP3_1200x630.png

%A affiche Blend ou True si le canal alpha est actif.

Version par lot, sans rognage, bandes transparentes

1
2
3
4
5
6
mkdir -p ok
for f in *.png; do
  [ "$(identify -format '%wx%h' "$f")" = "1200x630" ] && continue
  magick "$f" -auto-orient -resize 1200x630 -background none \
    -gravity center -extent 1200x630 -strip "ok/$f"
done

Vérification

Puis vérifiez la taille et le front matter :

1
identify -format "%f %wx%h\n" Configuration_Nginx_HTTP2_HTTP3_1200x630.png
1
2
3
image:
  path: /chemin/Configuration_Nginx_HTTP2_HTTP3_1200x630.png
  alt: ...

Pour appliquer le même traitement à toutes les images qui ne sont pas en 1200x630, la boucle par lot vue plus haut fait déjà exactement l’option 1 : il suffit de la lancer dans le bon dossier. Si vous voulez ne traiter que les images non conformes, voici une variante qui saute celles déjà à la bonne taille :

1
2
3
4
5
6
mkdir -p ok
for f in *.png; do
  [ "$(identify -format '%wx%h' "$f")" = "1200x630" ] && continue
  magick "$f" -auto-orient -resize 1200x630^ -gravity center \
    -background white -alpha remove -alpha off -extent 1200x630 -strip "ok/$f"
done

Une fois les fichiers générés dans ok/, pensez à les copier à la place des originaux (ou à adapter les chemins du front matter).