Social-Media-Bilder und Symbole
Wenn jemand den Link der Website in X, LinkedIn, Slack, Discord oder WhatsApp einfügt, sollte ein großes Bild mit einer lesbaren Überschrift erscheinen. Browser und Mobilgeräte sollten ein scharfes Symbol anzeigen.
1. Überprüfung
- App-Ordner (
src/app/oderapp/), vorhandenefavicon.ico,icon.*,apple-icon.*,opengraph-image.*,twitter-image.*. metadataBaseim Root-Layout. Ohne sie sind og:image-URLs relativ und Social-Media-Plattformen ignorieren sie. Wenn es fehlt, füge es hinzu (siehe den Skilllaunch-seo, oder setzemetadataBase: new URL("https://your-domain.com")).next.config.*:output: "export"?- Marke: Name, Slogan, Primärfarbe, Logo (SVG bevorzugt). Verwende Tokens aus
globals.csswieder. - Lies die versionsabgestimmte Dokumentation:
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. Open Graph-Bild (site-weit)
Kopiere assets/opengraph-image.tsx nach app/opengraph-image.tsx und bearbeite die Markenwerte. Es exportiert alt, size (1200×630) und contentType und zeichnet das Bild mit ImageResponse von next/og.
Designregeln für Teilen-Bilder:
- Überschrift mit 3–8 Wörtern, mindestens 64 px, hoher Kontrast. Sie muss als 300 px breite Miniaturansicht lesbar sein.
- Halte wichtige Inhalte innerhalb der zentralen 1000×500 Fläche; einige Plattformen beschneiden die Ränder.
- Markenzeichen + Domainname in einer Ecke, damit die Leute wissen, wohin der Link führt.
- Nur Flexbox:
ImageResponseunterstützt eine Teilmenge von CSS (display: flex, kein Grid). Jedes Element mit mehr als einem Kind benötigtdisplay: "flex". - Schriftarten: Die Standardschriftart funktioniert sofort. Für eine benutzerdefinierte Schriftart lade eine
.ttf/.otf/.woff-Datei (nicht.woff2) mitreadFileund übergib sie in der Optionfonts, wie in der Dokumentation gezeigt. - Größenlimit: 8 MB für Open Graph, 5 MB für Twitter. Generierte PNGs sind normalerweise unter 100 KB.
twitter-image ist optional: Wenn es fehlt, verwendet X das Open Graph-Bild. Stelle sicher, dass die Root-Metadaten twitter: { card: "summary_large_image" } setzen.
3. Seitenbezogene Bilder (Blogbeiträge, Dokumentationen, Produktseiten)
Füge opengraph-image.tsx innerhalb des dynamischen Segments hinzu, z. B. app/blog/[slug]/opengraph-image.tsx. Es erhält params (ein Promise) und kann den Beitragstitel laden; exportiere generateStaticParams aus der Bilddatei, damit jedes Bild vorgerendert wird. Behalte dieselbe Vorlage bei, damit alle geteilten Inhalte wie eine Marke aussehen.
Dies ist wichtiger, als es scheint: Wenn eine Seite ihr eigenes openGraph in metadata/generateMetadata setzt, ersetzt es das openGraph-Objekt des übergeordneten Elements, und das Root-Share-Bild verschwindet von dieser Seite. Eine opengraph-image-Datei auf Segmentebene (oder ein explizites openGraph.images) behebt das.
4. Symbole
Datei (in app/) | Größe | Zweck |
|---|---|---|
favicon.ico | 32×32 (multi-size ok) | Browser-Tab, erforderlich im App-Root |
icon.png oder icon.svg | 512×512 PNG oder SVG | Moderne Browser, Android |
apple-icon.png | 180×180 | iOS-Startbildschirm |
Du kannst auch icon.tsx / apple-icon.tsx mit ImageResponse generieren – siehe assets/icon.tsx. Ersetze das standardmäßige favicon.ico von create-next-app vor dem Start; wenn kein .ico-Tool verfügbar ist, ist ein 32×32 icon.png plus das Löschen des alten favicon.ico akzeptabel.
5. Hinweis zum statischen Export
Mit output: "export" (getestet auf Next.js 16.4):
cacheComponentsmuss für einen statischen Export deaktiviert sein, und jede generierte Bilddatei (opengraph-image.tsx,icon.tsx,apple-icon.tsx) benötigtexport const dynamic = "force-static";, sonst schlägt der Build fehl. Dynamische Segmente benötigen außerdemgenerateStaticParams.- Generierte Bilder werden ohne Dateierweiterung exportiert (
out/opengraph-image), sodass statische Hosts sie ohne einenContent-Type-Header ausliefern (getestet auf Cloudflare Pages). Einige Crawler lehnen das ab. Die beste Lösung für das site-weite Bild: Öffne/opengraph-imageauf der laufenden Website, speichere es und committe es alsapp/opengraph-image.png(dann lösche die.tsx); es exportiert alsopengraph-image.pngmit dem richtigen Typ. Gleiches für Symbole (app/icon.png,app/apple-icon.png). Für beitragsbezogene Bilder setzeContent-Type: image/pngfür diese Pfade in der Header-Datei des Hosts (public/_headersauf Cloudflare Pages/Netlify).
6. Verifizierung
-
npm run buildmuss erfolgreich sein. Die Build-Ausgabe listet dieopengraph-image-Routes auf. -
Starte die Website (
npm run start, oder diene denout/-Ordner) und führe den Prüfer aus (Node 18+, keine Abhängigkeiten).<skill-dir>ist der Ordner, der diese SKILL.md enthält:node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-postEs liest die
og:*- undtwitter:*-Tags der Seite, lädt das Bild herunter und überprüft absolute URL, HTTP-Status, Dateigröße, Abmessungen (1200×630),og:image:altundtwitter:card. Lokale URLs in den Tags werden gemeldet, da dies bedeutet, dassmetadataBasefür die Produktion fehlt oder falsch ist. -
Öffne die Bild-URL im Browser und betrachte sie. Überprüfe, ob der Text lesbar ist, wenn das Browserfenster schmal ist.
-
Nach dem Deployment sage dem Benutzer, er solle mit den eigenen Tools der Plattformen testen (LinkedIn Post Inspector, Facebook Sharing Debugger). Diese aktualisieren auch zwischengespeicherte Vorschauen.
Bericht
Liste die erstellten Bild- und Symboldateien, die Ausgabe des Prüfers und eine Erinnerung auf, dass Plattformen Vorschauen zwischenspeichern: Nach dem Ändern des Bildes sollte mit den obigen Tools erneut gescrapt werden.