Social Sharing und Favicons
Das Einzige, was zählt
og:image und og:url müssen absolute URLs auf einem öffentlich erreichbaren Host sein.
Der Crawler ruft sie von seinen eigenen Servern ab. Er hat keinen Seitenkontext, keine Cookies, keinen
Referer und keine Ahnung, worauf sich ein relativer Pfad bezieht. Ein Pfad wie
/assets/og.jpg oder assets/og.jpg löst sich in nichts auf, und die Karte bleibt leer.
<!-- Tot: Rendert eine leere Karte überall -->
<meta property="og:image" content="assets/images/og-image.jpg">
<!-- Funktioniert -->
<meta property="og:image" content="https://example.com/assets/images/og-image.jpg">
Dies ist der häufigste Grund, warum eine Vorschau nicht funktioniert. Bevor Sie etwas anderes debuggen, bestätigen Sie, dass die URL absolut ist und in einem privaten Fenster lädt.
Die Kehrseite: Vorschauen können auf localhost oder file:// nicht funktionieren. Nichts, was Sie lokal
tun, wird eine echte Vorschau erzeugen. Stellen Sie zuerst bereit, dann validieren Sie.
Der Tag-Satz
<link rel="canonical" href="https://example.com/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="Brand">
<meta property="og:locale" content="en_US">
<meta property="og:url" content="https://example.com/">
<meta property="og:title" content="Brand – was es ist">
<meta property="og:description" content="Ein Satz. Etwa 110 Zeichen.">
<meta property="og:image" content="https://example.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="Was ist auf dem Bild.">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Brand – was es ist">
<meta name="twitter:description" content="Ein Satz. Etwa 110 Zeichen.">
<meta name="twitter:image" content="https://example.com/og-image.jpg">
<meta name="twitter:image:alt" content="Was ist auf dem Bild.">
Drei Details, die leicht falsch gemacht werden:
og: verwendet property=, twitter: verwendet name=. Eine Verwechslung wird stillschweigend
ignoriert, sodass die Tags im Quelltext vorhanden erscheinen und nichts bewirken. Einige Parser tolerieren
name= bei og:, aber verlassen Sie sich nicht darauf.
twitter:card muss summary_large_image sein. Der Standardwert ist eine kleine quadratische Karte
mit dem Bild als Miniaturansicht neben dem Text, was ein 1200x630-Bild verschwendet.
Die Angabe von og:image:width und og:image:height bewirkt, dass die Karte sofort gerendert wird.
Ohne sie muss die Plattform das Bild herunterladen, bevor sie das Seitenverhältnis kennt, sodass die erste
Person, die den Link teilt, oft eine reine Textkarte sieht. Sie müssen mit der tatsächlichen Datei
übereinstimmen. Messen Sie es, gehen Sie nicht davon aus.
Kopienlänge: Titel werden bei etwa 60 Zeichen abgeschnitten, Beschreibungen je nach Plattform zwischen 110 und 200 Zeichen. Laden Sie die Bedeutung vor.
Das Share-Bild
1200x630 (1,905:1). JPEG, es sei denn, das Design benötigt Alpha, was es nicht tut, da jede Plattform auf Weiß komponiert. Halten Sie es unter etwa 1 MB; die harten Grenzen sind 8 MB (Facebook) und 5 MB (X), aber große Dateien führen beim Scraping zu Zeitüberschreitungen.
Rendern Sie es im Zielverhältnis, beschneiden Sie keinen Screenshot
Das Aufnehmen eines beliebigen Screenshots und das Zuschneiden auf 1,905:1 verwirft die Komposition, die der Designer gewählt hat. Rendern Sie die Quelle stattdessen im Verhältnis:
# 1440x756 sind exakt 1,905:1, sodass es auf 1200x630 skaliert wird, ohne Beschnitt
chrome --headless --disable-gpu --hide-scrollbars --virtual-time-budget=8000 \
--window-size=1440,756 --screenshot=og-src.png "file://$PWD/index.html"
Die Kurz-Viewport-Falle
Wenn die Seite einen vollständigen Hero-Bereich hat (100vh / 100svh), ergibt das Rendern direkt bei 1,905:1
einen Viewport, der viel kürzer ist als ein echter Desktop-Bildschirm. Jegliche object-fit: cover-Medien
beschneiden viel stärker als in der realen Nutzung, und Elemente, die sich normalerweise ausweichen,
kollidieren – typischerweise ein Header-Logo, das auf dem Kopf des Motivs landet.
Rendern Sie in einem höheren Viewport, damit die Medien so beschnitten werden wie in der realen Nutzung, und schneiden Sie dann das 1,905:1-Fenster daraus aus:
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 # oben verankert
Vergleichen Sie einen oben verankerten Beschnitt mit einem zentrierten, bevor Sie sich entscheiden. Oben verankert behält in der Regel die Markenelemente (Utility-Leiste, Navigation, Wortmarke); zentriert behält in der Regel das Motiv und den Call-to-Action. Sie können nicht beides haben, da ein vollständiger Hero-Bereich höher ist, als 1,905:1 erlaubt.
Rahmung
Karten werden im Feed etwa 500 Pixel breit gerendert, und jede Plattform beschneidet anders (LinkedIn und Slack sind enger als Facebook). Halten Sie alles, was überleben muss, innerhalb der zentralen 80%, und setzen Sie jeglichen Text groß genug, um ihn bei halber Größe lesen zu können. Feine UI-Details verschwinden; eine große Wortmarke und ein starkes Bild tun das nicht.
Favicons
Die Schriftartenfalle
Setzen Sie kein <text> in ein SVG-Favicon.
<!-- Zerbricht: Rendert in der Fallback-Schriftart, die der Betrachter zufällig hat -->
<svg ...><text x="50%" y="50%" font-family="Geist">G</text></svg>
Das SVG wird auf dem Rechner des Betrachters gerendert, auf dem Ihre Webschriftart nicht existiert. Extrahieren Sie die Glyphe als Pfad, sodass sie schriftartenunabhängig und auflösungsunabhängig ist. Siehe das Skript unten.
Die Transparenzfalle
Eine dunkle Glyphe auf transparentem Hintergrund verschwindet vor dunkler Browser-Chrome, und eine helle verschwindet auf heller. Zeichnen Sie das Symbol auf einer gefüllten Kachel. Es verleiht der Marke auch eine konsistente Silhouette über Tab-Leisten, Lesezeichen und Startbildschirme hinweg.
Der Dateisatz
| Datei | Größe | Warum |
|---|---|---|
/favicon.ico | 16, 32, 48 | Browser fordern diesen Pfad implizit an, auch wenn Sie andere deklarieren; halten Sie ihn im Web-Root |
favicon.svg | skalierbar | Was moderne Browser bevorzugen, und es bleibt auf jedem Display scharf |
apple-touch-icon.png | 180 | iOS-Startbildschirm |
icon-192.png | 192 | Manifest |
icon-512.png | 512 | Manifest, Splash-Screens |
icon-maskable-512.png | 512 | Android adaptive Masken |
<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">
Die maskierbare Sicherheitszone
Android beschneidet Symbole in beliebige Formen (Kreis, abgerundetes Quadrat, Tropfen). Ein maskable-Symbol
muss alles Bedeutungsvolle innerhalb des zentralen 80%-Kreises behalten, was bedeutet, dass etwa
40% der Kachelkante wegwerfbarer Abstand ist. Wenn Sie das normale Symbol wiederverwenden, werden seine
Kanten abgeschnitten.
In der Praxis: Wenn die Glyphe 60% der Kachel im Standardsymbol bedeckt, reduzieren Sie sie auf etwa
40% für das maskierbare. Liefern Sie beide, mit "purpose": "any" und "purpose": "maskable"
als separate Einträge. Setzen Sie niemals beide Zwecke in eine Datei.
Web-Manifest
{
"name": "Brand",
"short_name": "Brand",
"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 färbt die mobile Browser-Chrome ein, sollte also mit dem übereinstimmen, was sich ganz oben
auf der Seite befindet, nicht mit der Hauptfarbe der Marke. Wenn die Seite mit einer schwarzen Utility-Leiste
beginnt, verwenden Sie dieses Schwarz. Eine Abweichung wirkt wie ein Rendering-Fehler. Spiegeln Sie es in
<meta name="theme-color"> wider.
background_color ist der Splash-Screen hinter dem Symbol vor dem ersten Paint, sollte also mit dem
Seitenhintergrund übereinstimmen.
Generierungsskript
Benötigt pillow und fonttools. Erzeugt den gesamten Symbolsatz sowie das Share-Bild.
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 = "brand.ttf" # die echte Markenschriftart, in der Gewichtung der Wortmarke
CHAR = "G"
INK = "#0a0a0a" # Kachel
PAPER = "#f2f1ed" # Glyphe
COVER = 0.60 # Glyphenhöhe als Anteil der Kachel
OUT = "assets/icons"
os.makedirs(OUT, exist_ok=True)
# ── SVG: Glyphe als echter Pfad, sodass sie nicht von den Schriftarten des Betrachters abhängt ──
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 wird gespiegelt: Schriftarten sind y-nach oben, SVG ist y-nach unten
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>')
# ── Raster-Kacheln ────────────────────────────────────────────────────────────
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) # 40% Sicherheitszone
tile(256).save("favicon.ico", sizes=[(16, 16), (32, 32), (48, 48)])
# ── Share-Bild: Beschneiden eines größeren Rendert auf das Verhältnis, dann herunterskalieren ──────────────
src = Image.open("og-src.png").convert("RGB") # z.B. 1440x1000
src.crop((0, 0, 1440, 756)).resize((1200, 630), Image.LANCZOS).save(
"assets/images/og-image.jpg", quality=88, optimize=True, progressive=True)
Keine Markenschriftart verfügbar? Jede geometrische Groteske funktioniert für ein Monogramm. Das Rastern eines
vorhandenen Logo-PNGs auf die Kachel ist ebenfalls in Ordnung; zentrieren Sie es einfach innerhalb desselben COVER-Anteils
und halten Sie die maskierbare Variante kleiner.
Vor dem Bereitstellen überprüfen
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} ist nicht absolut: {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"]), "deklarierte Größe ist falsch"
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"fehlendes Symbol {i['src']}"
print("ok")
Checkliste:
-
og:imageundog:urlabsolut, auf dem echten Host, laden in einem privaten Fenster - deklarierte
og:image:width/heightstimmen mit der tatsächlichen Datei überein -
twitter:cardistsummary_large_image -
og:-Tags verwendenproperty=,twitter:-Tags verwendenname= - jeder Platzhalter-Domain ersetzt (danach suchen; es gibt normalerweise vier)
-
favicon.icoim Web-Root, nicht nur in einem Assets-Ordner - SVG-Favicon enthält einen
<path>, kein<text> - Symbolkachel ist gefüllt, sodass sie sowohl in dunkler als auch heller Browser-Chrome überlebt
- maskierbares Symbol auf die zentralen 80% aufgepolstert
-
theme_colorstimmt mit der Oberkante der Seite überein
Caching
Jede Plattform cacht aggressiv und wird nach einer Korrektur weiterhin die alte Karte ausliefern. Erneutes Scraping:
- Facebook, Instagram, WhatsApp: https://developers.facebook.com/tools/debug/
- X: https://cards-dev.twitter.com/validator
- LinkedIn: https://www.linkedin.com/post-inspector/
LinkedIn cacht am stärksten und ignoriert Änderungen effektiv für etwa 7 Tage, es sei denn, Sie führen den
Inspektor aus. Wenn eine URL bereits weit verbreitet mit einer defekten Karte geteilt wurde, erzwingt das Hinzufügen
eines Query-Strings (?v=2) ein erneutes Scraping.
Favicons werden auch im Browser hart gecacht. Testen Sie in einem privaten Fenster; ein normaler Neuladevorgang liefert normalerweise das alte Symbol weiter.
Platzhalter-Domains
Wenn die echte Domain noch nicht bekannt ist, verwenden Sie eine Subdomain von example.com
(https://brand.example.com). RFC 2606 reserviert sie, sodass sie unmissverständlich ein Platzhalter ist
und niemals versehentlich auf eine Domain zeigen kann, die jemand anderes besitzt. Hinterlassen Sie keine
plausible, aber nicht besessene Domain in ausgelieferten Metadaten.
Setzen Sie die Ersetzungsanweisung in einen Kommentar direkt über dem Block und in die
Projekt-README, und geben Sie an, wie viele Vorkommen es gibt. Normalerweise sind es vier: canonical,
og:url, og:image, twitter:image.