Communitygithub.com

Prévisualisation de liens et favicons

Générez des prévisualisations de liens et favicons fonctionnels – balises Open Graph et Twitter Card, image de partage au format 1200x630, et jeu complet de favicons (SVG, ICO, apple-touch, icons manifeste).

Qu'est-ce que Prévisualisation de liens et favicons ?

Cette compétence traite le problème critique des prévisualisations de liens qui s'affichent blanches ou avec la mauvaise image, ainsi que des favicons qui ne se chargent pas correctement. Elle explique pourquoi une URL absolue sur un hôte accessible publiquement est indispensable pour tout métabalise `og:image` ou `og:url`. Elle fournit un guide détaillé pour configurer l'ensemble des balises Open Graph et Twitter Card, y compris les pièges courants comme l'utilisation de `property=` pour les balises `og:` et de `name=` pour les balises `twitter:`. La compétence couvre également la création d'une image de partage au format 1200x630, avec des techniques de rendu pour éviter les mauvais recadrages (trap du viewport court). Pour les favicons, elle propose un jeu complet de fichiers : ICO, SVG (sans piège de police), PNG pour iOS et Android, et un script de génération Python basé sur Pillow et fonttools. Enfin, elle aborde le manifeste web, le débogage avec les validateurs des plateformes sociales, et la mise en cache.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/social-share-favicons

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

FichierTaillePourquoi
/favicon.ico16, 32, 48les navigateurs demandent ce chemin implicitement même si vous en déclarez d'autres ; gardez-le à la racine web
favicon.svgévolutifce que les navigateurs modernes préfèrent, et il reste net sur tous les écrans
apple-touch-icon.png180écran d'accueil iOS
icon-192.png192manifeste
icon-512.png512manifeste, écrans de démarrage
icon-maskable-512.png512masques 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:image et og:url absolues, sur le vrai hôte, se chargeant dans une fenêtre privée
  • Les og:image:width / height déclarés correspondent au fichier réel
  • twitter:card est summary_large_image
  • Les balises og: utilisent property=, les balises twitter: utilisent name=
  • 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_color correspond 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 :

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.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Skills associés