Partage social et favicons
Ce qui compte vraiment
og:image et og:url doivent être des URL absolues sur un hôte accessible publiquement.
Le robot d'exploration les récupère depuis ses propres serveurs. Il n'a aucun contexte de page, aucun cookie, aucun référent, et aucune idée de ce que votre chemin relatif signifie. Un chemin comme /assets/og.jpg ou assets/og.jpg ne résout rien et la carte revient blanche.
<!-- mort : crée une carte vide partout -->
<meta property="og:image" content="assets/images/og-image.jpg">
<!-- fonctionne -->
<meta property="og:image" content="https://exemple.com/assets/images/og-image.jpg">
C'est la raison la plus courante pour laquelle un aperçu ne fonctionne pas. Avant de déboguer quoi que ce soit d'autre, confirmez que l'URL est absolue et se charge dans une fenêtre privée.
Le corollaire : les aperçus ne peuvent pas fonctionner sur localhost ou file://. Rien de ce que vous faites localement ne produira un vrai aperçu. Déployez d'abord, puis validez.
Le jeu de balises
<link rel="canonical" href="https://exemple.com/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="Marque">
<meta property="og:locale" content="fr_FR">
<meta property="og:url" content="https://exemple.com/">
<meta property="og:title" content="Marque - ce que c'est">
<meta property="og:description" content="Une phrase. Environ 110 caractères.">
<meta property="og:image" content="https://exemple.com/og-image.jpg">
<meta property="og:image:type" content="image/jpeg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Ce qu'il y a dans l'image.">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Marque - ce que c'est">
<meta name="twitter:description" content="Une phrase. Environ 110 caractères.">
<meta name="twitter:image" content="https://exemple.com/og-image.jpg">
<meta name="twitter:image:alt" content="Ce qu'il y a dans l'image.">
Trois détails faciles à rater :
og: utilise property=, twitter: utilise name=. Les mélanger est ignoré silencieusement, donc les balises semblent présentes dans le code source mais ne font rien. Certains analyseurs tolèrent name= pour og:, mais ne comptez pas dessus.
twitter:card doit être summary_large_image. La valeur par défaut est une petite carte carrée avec l'image en miniature à côté du texte, ce qui gaspille une image 1200x630.
Déclarer og:image:width et og:image:height permet à la carte de s'afficher immédiatement. Sans cela, la plateforme doit télécharger l'image avant de connaître le ratio, donc la première personne à partager le lien voit souvent une carte sans image. Elles doivent correspondre au fichier réel. Mesurez-le, ne supposez pas.
Longueur des copies : les titres sont coupés vers 60 caractères, les descriptions vers 110 à 200 selon la plateforme. Mettez le sens au début.
L'image de partage
1200x630 (1.905:1). JPEG sauf si le design a besoin d'alpha, ce qui n'est pas le cas car chaque plateforme composite sur du blanc. Restez sous environ 1 Mo ; les limites strictes sont 8 Mo (Facebook) et 5 Mo (X), mais les fichiers volumineux expirent lors du scraping.
Rendez-la au ratio cible, ne recadrez pas une capture d'écran
Prendre une capture d'écran arbitraire et la recadrer à 1.905:1 jette la composition choisie par le designer. Rendez la source au ratio à la place :
# 1440x756 est exactement 1.905:1, donc il réduit à 1200x630 sans recadrage
chrome --headless --disable-gpu --hide-scrollbars --virtual-time-budget=8000 \
--window-size=1440,756 --screenshot=og-src.png "file://$PWD/index.html"
Le piège du viewport court
Si la page a un hero pleine hauteur (100vh / 100svh), le rendu direct en 1.905:1 donne un viewport bien plus court qu'un écran de bureau réel. Tout média avec object-fit: cover recadre beaucoup plus fort que dans l'usage réel, et des éléments qui normalement se dégagent les uns des autres entrent en collision - typiquement un logo d'en-tête qui atterrit sur la tête du sujet.
Rendez dans un viewport plus haut pour que le média recadre comme dans l'usage réel, puis découpez la fenêtre 1.905:1 :
chrome --headless ... --window-size=1440,1000 --screenshot=og-src.png "file://$PWD/index.html"
ffmpeg -i og-src.png -vf "crop=1440:756:0:0" -q:v 2 og-crop.png # ancré en haut
Comparez un recadrage ancré en haut avec un centré avant de choisir. L'ancrage en haut garde généralement le mobilier de marque (barre utilitaire, navigation, logotype) ; le centré garde généralement le sujet et l'appel à l'action. Vous ne pouvez pas avoir les deux, car un hero pleine hauteur est plus haut que ce que 1.905:1 permet.
Cadrage
Les cartes s'affichent autour de 500 px de large dans un fil, et chaque plateforme recadre différemment (LinkedIn et Slack sont plus serrés que Facebook). Gardez ce qui doit survivre à l'intérieur des 80% centraux et mettez tout texte en taille suffisante pour être lu à moitié taille. Les détails fins d'interface disparaissent ; un grand logotype et une image forte non.
Favicons
Le piège de la police
Ne mettez pas <text> dans un favicon SVG.
<!-- cassé : s'affiche dans la police de remplacement que le spectateur a par hasard -->
<svg ...><text x="50%" y="50%" font-family="Geist">G</text></svg>
Le SVG s'affiche sur la machine du spectateur, où votre police web n'existe pas. Extrayez le glyphe sous forme de chemin pour qu'il soit indépendant de la police et de la résolution. Voir le script ci-dessous.
Le piège de la transparence
Un glyphe foncé sur fond transparent disparaît sur un chrome de navigateur sombre, et un clair disparaît sur un fond clair. Dessinez l'icône sur une tuile remplie. Cela donne aussi à la marque une silhouette cohérente dans les barres d'onglets, les favoris et les écrans d'accueil.
Le jeu de fichiers
| Fichier | Taille | Pourquoi |
|---|---|---|
/favicon.ico | 16, 32, 48 | les navigateurs demandent ce chemin implicitement même si vous en déclarez d'autres ; gardez-le à la racine web |
favicon.svg | évolutif | ce que les navigateurs modernes préfèrent, et il reste net sur tous les écrans |
apple-touch-icon.png | 180 | écran d'accueil iOS |
icon-192.png | 192 | manifeste |
icon-512.png | 512 | manifeste, écrans de démarrage |
icon-maskable-512.png | 512 | masques adaptatifs Android |
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/assets/icons/favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/assets/icons/apple-touch-icon.png">
<link rel="manifest" href="/site.webmanifest">
La zone de sécurité maskable
Android découpe les icônes en formes arbitraires (cercle, squirèle, larme). Une icône maskable doit garder tout ce qui a du sens à l'intérieur du cercle central à 80%, ce qui signifie qu'environ 40% du bord de la tuile est un rembourrage jetable. Réutilisez l'icône normale et ses bords seront coupés.
En pratique : si le glyphe couvre 60% de la tuile dans l'icône standard, réduisez-le à environ 40% pour l'icône maskable. Livrez les deux, avec "purpose": "any" et "purpose": "maskable" comme entrées séparées. Ne mettez jamais les deux purposes sur un seul fichier.
Manifeste web
{
"name": "Marque",
"short_name": "Marque",
"start_url": "/",
"scope": "/",
"display": "standalone",
"background_color": "#f7f6f4",
"theme_color": "#0a0a0a",
"icons": [
{ "src": "/assets/icons/favicon.svg", "type": "image/svg+xml", "sizes": "any" },
{ "src": "/assets/icons/icon-192.png", "type": "image/png", "sizes": "192x192", "purpose": "any" },
{ "src": "/assets/icons/icon-512.png", "type": "image/png", "sizes": "512x512", "purpose": "any" },
{ "src": "/assets/icons/icon-maskable-512.png", "type": "image/png", "sizes": "512x512", "purpose": "maskable" }
]
}
theme_color teinte le chrome du navigateur mobile, il doit donc correspondre à ce qui se trouve tout en haut de la page, pas à la couleur principale de la marque. Si la page s'ouvre sur une barre utilitaire noire, utilisez ce noir. Un décalage ressemble à un bug de rendu. Miroir dans <meta name="theme-color">.
background_color est l'écran de démarrage derrière l'icône avant le premier rendu, il doit donc correspondre à l'arrière-plan de la page.
Script de génération
Nécessite pillow et fonttools. Produit l'ensemble complet des icônes plus l'image de partage.
import os
from PIL import Image, ImageDraw, ImageFont
from fontTools.ttLib import TTFont
from fontTools.pens.svgPathPen import SVGPathPen
from fontTools.pens.boundsPen import BoundsPen
FONT = "marque.ttf" # la vraie police de la marque, au poids utilisé par le logotype
CHAR = "G"
INK = "#0a0a0a" # tuile
PAPER = "#f2f1ed" # glyphe
COVER = 0.60 # hauteur du glyphe en part de la tuile
OUT = "assets/icons"
os.makedirs(OUT, exist_ok=True)
# ── SVG : glyphe sous forme de chemin réel, pour ne pas dépendre des polices du spectateur ──
f = TTFont(FONT)
gs = f.getGlyphSet()
name = f.getBestCmap()[ord(CHAR)]
bp = BoundsPen(gs); gs[name].draw(bp)
x0, y0, x1, y1 = bp.bounds
pen = SVGPathPen(gs); gs[name].draw(pen)
d = pen.getCommands()
VB = 64
s = (VB * COVER) / (y1 - y0)
tx = (VB - (x1 - x0) * s) / 2 - x0 * s
ty = (VB + (y1 - y0) * s) / 2 + y0 * s # y s'inverse : les polices sont y vers le haut, SVG est y vers le bas
open(f"{OUT}/favicon.svg", "w").write(
f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {VB} {VB}">'
f'<rect width="{VB}" height="{VB}" fill="{INK}"/>'
f'<path transform="translate({tx:.3f} {ty:.3f}) scale({s:.5f} -{s:.5f})" '
f'd="{d}" fill="{PAPER}"/></svg>')
# ── Tuiles matricielles ────────────────────────────────────────────────────────────
def tile(px, cover=COVER):
img = Image.new("RGB", (px, px), INK)
dr = ImageDraw.Draw(img)
fnt = ImageFont.truetype(FONT, px * 2)
bb = dr.textbbox((0, 0), CHAR, font=fnt)
fnt = ImageFont.truetype(FONT, int(px * 2 * (px * cover) / (bb[3] - bb[1])))
bb = dr.textbbox((0, 0), CHAR, font=fnt)
dr.text(((px - (bb[2] - bb[0])) / 2 - bb[0],
(px - (bb[3] - bb[1])) / 2 - bb[1]), CHAR, font=fnt, fill=PAPER)
return img
tile(180).save(f"{OUT}/apple-touch-icon.png", optimize=True)
tile(192).save(f"{OUT}/icon-192.png", optimize=True)
tile(512).save(f"{OUT}/icon-512.png", optimize=True)
tile(512, cover=0.42).save(f"{OUT}/icon-maskable-512.png", optimize=True) # zone de sécurité 40%
tile(256).save("favicon.ico", sizes=[(16, 16), (32, 32), (48, 48)])
# ── Image de partage : découper un rendu plus haut au ratio, puis réduire ──────────────
src = Image.open("og-src.png").convert("RGB") # ex. 1440x1000
src.crop((0, 0, 1440, 756)).resize((1200, 630), Image.LANCZOS).save(
"assets/images/og-image.jpg", quality=88, optimize=True, progressive=True)
Pas de police de marque disponible ? N'importe quelle grotesque géométrique fonctionne pour un monogramme. La rastérisation d'un logo PNG existant sur la tuile est aussi acceptable ; centrez-le simplement à la même fraction COVER et gardez la variante maskable plus petite.
Vérifiez avant de publier
import re, json, os
from PIL import Image
s = open("index.html").read()
tags = dict(re.findall(r'(?:property|name)="((?:og|twitter):[^"]+)"\s+content="([^"]+)"', s))
for t in ("og:url", "og:image", "twitter:image"):
assert tags[t].startswith("http"), f"{t} n'est pas absolue : {tags[t]}"
w, h = Image.open("assets/images/og-image.jpg").size
assert (str(w), str(h)) == (tags["og:image:width"], tags["og:image:height"]), "la taille déclarée est fausse"
assert tags["twitter:card"] == "summary_large_image"
m = json.load(open("site.webmanifest"))
for i in m["icons"]:
assert os.path.isfile(i["src"].lstrip("/")), f"icône manquante {i['src']}"
print("ok")
Liste de vérification :
-
og:imageetog:urlabsolues, sur le vrai hôte, se chargeant dans une fenêtre privée - Les
og:image:width/heightdéclarés correspondent au fichier réel -
twitter:cardestsummary_large_image - Les balises
og:utilisentproperty=, les balisestwitter:utilisentname= - Chaque domaine factice remplacé (cherchez-le ; il y en a généralement quatre)
-
favicon.icoà la racine web, pas seulement dans un dossier assets - Le favicon SVG contient un
<path>, pas de<text> - La tuile de l'icône est remplie, pour survivre aux chromes de navigateur sombres et clairs
- L'icône maskable est rembourrée au 80% central
-
theme_colorcorrespond au bord supérieur de la page
Mise en cache
Chaque plateforme met fortement en cache et continuera de servir l'ancienne carte après l'avoir corrigée. Re-scrapez :
- Facebook, Instagram, WhatsApp : https://developers.facebook.com/tools/debug/
- X : https://cards-dev.twitter.com/validator
- LinkedIn : https://www.linkedin.com/post-inspector/
LinkedIn met le plus fortement en cache et ignore effectivement les changements pendant environ 7 jours sauf si vous exécutez l'inspecteur. Si une URL a déjà été largement partagée avec une carte cassée, ajouter une chaîne de requête (?v=2) force un nouveau scraping.
Les favicons sont aussi fortement mis en cache dans le navigateur. Testez dans une fenêtre privée ; un rechargement normal continuera généralement de servir l'ancienne.
Domaines factices
Lorsque le vrai domaine n'est pas encore connu, utilisez un sous-domaine de example.com (https://marque.example.com). RFC 2606 le réserve, donc c'est indubitablement un espace réservé et ne peut jamais pointer accidentellement vers un domaine appartenant à quelqu'un d'autre. Ne laissez jamais un domaine plausible mais non possédé dans les métadonnées publiées.
Mettez l'instruction de remplacement dans un commentaire directement au-dessus du bloc et dans le README du projet, et dites combien il y a d'occurrences. C'est normalement quatre : canonical, og:url, og:image, twitter:image.