Compartir en redes sociales y favicons
Lo único que importa
og:image y og:url deben ser URLs absolutas en un host accesible públicamente.
El rastreador las obtiene desde sus propios servidores. No tiene contexto de página, ni cookies, ni referer, ni idea de a qué se refiere tu ruta relativa. Una ruta como /assets/og.jpg o assets/og.jpg se resuelve a nada y la tarjeta vuelve en blanco.
<!-- muerto: renderiza una tarjeta vacía en todas partes -->
<meta property="og:image" content="assets/images/og-image.jpg">
<!-- funciona -->
<meta property="og:image" content="https://ejemplo.com/assets/images/og-image.jpg">
Esta es la razón más común por la que una vista previa no funciona. Antes de depurar cualquier otra cosa, confirma que la URL sea absoluta y cargue en una ventana privada.
El corolario: las vistas previas no pueden funcionar en localhost o file://. Nada de lo que hagas localmente producirá una vista previa real. Despliega primero, luego valida.
El conjunto de etiquetas
<link rel="canonical" href="https://ejemplo.com/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="Marca">
<meta property="og:locale" content="es_ES">
<meta property="og:url" content="https://ejemplo.com/">
<meta property="og:title" content="Marca - lo que es">
<meta property="og:description" content="Una oración. Alrededor de 110 caracteres.">
<meta property="og:image" content="https://ejemplo.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="Lo que hay en la imagen.">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Marca - lo que es">
<meta name="twitter:description" content="Una oración. Alrededor de 110 caracteres.">
<meta name="twitter:image" content="https://ejemplo.com/og-image.jpg">
<meta name="twitter:image:alt" content="Lo que hay en la imagen.">
Tres detalles que son fáciles de equivocar:
og: usa property=, twitter: usa name=. Mezclarlos se ignora silenciosamente, por lo que las etiquetas parecen presentes en el código fuente y no hacen nada. Algunos parsers toleran name= en og:, pero no confíes en ello.
twitter:card debe ser summary_large_image. El valor por defecto es una tarjeta cuadrada pequeña con la imagen como miniatura junto al texto, lo que desperdicia una imagen de 1200x630.
Declarar og:image:width y og:image:height hace que la tarjeta se renderice inmediatamente. Sin ellos, la plataforma tiene que descargar la imagen antes de saber la relación de aspecto, por lo que la primera persona que comparte el enlace a menudo ve una tarjeta solo de texto. Deben coincidir con el archivo real. Mídelo, no asumas.
Longitud de copia: los títulos se cortan alrededor de 60 caracteres, las descripciones alrededor de 110 a 200 según la plataforma. Pon el significado al principio.
La imagen para compartir
1200x630 (1.905:1). JPEG a menos que el diseño necesite alfa, que no es el caso, ya que cada plataforma compone sobre blanco. Mantenla por debajo de 1 MB; los límites duros son 8 MB (Facebook) y 5 MB (X), pero los archivos grandes agotan el tiempo de espera durante el raspado.
Renderedla en la proporción objetivo, no recortes una captura de pantalla
Tomar una captura de pantalla arbitraria y recortarla a 1.905:1 descarta la composición que eligió el diseñador. Renderiza la fuente en la proporción en su lugar:
# 1440x756 es exactamente 1.905:1, por lo que se reduce a 1200x630 sin recortar
chrome --headless --disable-gpu --hide-scrollbars --virtual-time-budget=8000 \
--window-size=1440,756 --screenshot=og-src.png "file://$PWD/index.html"
La trampa del viewport corto
Si la página tiene un héroe de altura completa (100vh / 100svh), renderizar directamente a 1.905:1 da un viewport mucho más corto que una pantalla de escritorio real. Cualquier medio con object-fit: cover recorta mucho más de lo que lo hace en uso real, y los elementos que normalmente se evitan chocan, típicamente un logotipo de encabezado que cae sobre la cabeza del sujeto.
Renderiza en un viewport más alto para que el medio recorte como lo hace en uso real, luego corta la ventana 1.905:1 de él:
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 # anclado arriba
Compara un recorte anclado arriba con uno centrado antes de elegir. El anclado arriba generalmente mantiene el mobiliario de la marca (barra de utilidades, navegación, marca); el centrado generalmente mantiene al sujeto y la llamada a la acción. No puedes tener ambos, porque un héroe de altura completa es más alto de lo que permite 1.905:1.
Enmarcado
Las tarjetas se renderizan alrededor de 500 px de ancho en un feed, y cada plataforma recorta de manera diferente (LinkedIn y Slack son más ajustados que Facebook). Mantén cualquier cosa que deba sobrevivir dentro del 80% central, y configura cualquier tipo lo suficientemente grande como para leerlo a la mitad del tamaño. El detalle fino de la interfaz de usuario desaparece; una marca grande y una imagen fuerte no.
Favicons
La trampa de las fuentes
No pongas <text> en un favicon SVG.
<!-- se rompe: renderiza en la fuente de respaldo que el visor tenga -->
<svg ...><text x="50%" y="50%" font-family="Geist">G</text></svg>
El SVG se renderiza en la máquina del visor, donde tu fuente web no existe. Extrae el glifo como una ruta para que sea independiente de la fuente y de la resolución. Consulta el script a continuación.
La trampa de la transparencia
Un glifo oscuro sobre un fondo transparente desaparece contra el cromo del navegador oscuro, y uno claro desaparece sobre el claro. Dibuja el icono sobre un mosaico relleno. También le da a la marca una silueta consistente en las barras de pestañas, marcadores y pantallas de inicio.
El conjunto de archivos
| Archivo | Tamaño | Por qué |
|---|---|---|
/favicon.ico | 16, 32, 48 | los navegadores solicitan esta ruta implícitamente incluso cuando declaras otras; mantenlo en la raíz web |
favicon.svg | escalable | lo que prefieren los navegadores modernos, y se mantiene nítido en cualquier pantalla |
apple-touch-icon.png | 180 | pantalla de inicio de iOS |
icon-192.png | 192 | manifiesto |
icon-512.png | 512 | manifiesto, pantallas de bienvenida |
icon-maskable-512.png | 512 | máscaras adaptables de 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 zona segura de máscara adaptable
Android recorta los iconos en formas arbitrarias (círculo, cuadrado redondeado, lágrima). Un icono maskable debe mantener todo lo significativo dentro del círculo central del 80%, lo que significa que aproximadamente el 40% del borde del mosaico es relleno desechable. Reutiliza el icono normal y se le cortarán los bordes.
En la práctica: si el glifo cubre el 60% del mosaico en el icono estándar, redúcelo a aproximadamente el 40% para el máscara adaptable. Entrega ambos, con "purpose": "any" y "purpose": "maskable" como entradas separadas. Nunca pongas ambos propósitos en un solo archivo.
Manifiesto web
{
"name": "Marca",
"short_name": "Marca",
"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 tiñe el cromo del navegador móvil, por lo que debe coincidir con lo que sea que esté en la parte superior de la página, no el color principal de la marca. Si la página se abre en una barra de utilidades negra, usa ese negro. Un desajuste se lee como un error de renderizado. Reflejalo en <meta name="theme-color">.
background_color es la pantalla de bienvenida detrás del icono antes de la primera pintura, por lo que debe coincidir con el fondo de la página.
Script de generación
Necesita pillow y fonttools. Produce el conjunto completo de iconos más la imagen para compartir.
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 = "marca.ttf" # la cara de la marca real, en el peso que usa la marca
CHAR = "G"
INK = "#0a0a0a" # mosaico
PAPER = "#f2f1ed" # glifo
COVER = 0.60 # altura del glifo como proporción del mosaico
OUT = "assets/icons"
os.makedirs(OUT, exist_ok=True)
# ── SVG: glifo como ruta real, para que no dependa de las fuentes del visor ──
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 se invierte: las fuentes tienen y hacia arriba, SVG tiene y hacia abajo
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>')
# ── Mosaicos rasterizados ────────────────────────────────────────────────────
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) # zona segura del 40%
tile(256).save("favicon.ico", sizes=[(16, 16), (32, 32), (48, 48)])
# ── Imagen para compartir: recorta un renderizado más alto a la proporción, luego reduce ──
src = Image.open("og-src.png").convert("RGB") # ej. 1440x1000
src.crop((0, 0, 1440, 756)).resize((1200, 630), Image.LANCZOS).save(
"assets/images/og-image.jpg", quality=88, optimize=True, progressive=True)
¿No hay una fuente de marca disponible? Cualquier grotesca geométrica funciona para un monograma. Rasterizar un logotipo PNG existente sobre el mosaico también está bien; solo centrado dentro de la misma fracción COVER y mantén la variante máscara adaptable más pequeña.
Verificar antes de enviar
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} no es absoluta: {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"]), "el tamaño declarado es incorrecto"
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"falta el icono {i['src']}"
print("ok")
Lista de verificación:
-
og:imageyog:urlabsolutas, en el host real, cargando en una ventana privada -
og:image:width/heightdeclarados coinciden con el archivo real -
twitter:cardessummary_large_image - las etiquetas
og:usanproperty=, las etiquetastwitter:usanname= - cada dominio de marcador de posición reemplazado (búscalo con grep; generalmente hay cuatro)
-
favicon.icoen la raíz web, no solo en una carpeta de activos - el favicon SVG contiene un
<path>, sin<text> - el mosaico del icono está relleno, para que sobreviva al cromo del navegador oscuro y claro
- icono máscara adaptable rellenado al 80% central
-
theme_colorcoincide con el borde superior de la página
Almacenamiento en caché
Cada plataforma almacena en caché agresivamente y seguirá sirviendo la tarjeta anterior después de que la arregles. Vuelve a raspar:
- Facebook, Instagram, WhatsApp: https://developers.facebook.com/tools/debug/
- X: https://cards-dev.twitter.com/validator
- LinkedIn: https://www.linkedin.com/post-inspector/
LinkedIn almacena en caché con más fuerza y efectivamente ignora los cambios durante unos 7 días a menos que ejecutes el inspector. Si una URL ya se ha compartido ampliamente con una tarjeta rota, agregar una cadena de consulta (?v=2) fuerza un raspado nuevo.
Los favicons también se almacenan en caché en el navegador. Prueba en una ventana privada; una recarga normal generalmente seguirá sirviendo la anterior.
Dominios de marcador de posición
Cuando el dominio real aún no se conoce, usa un subdominio de example.com (https://brand.example.com). RFC 2606 lo reserva, por lo que es inequívocamente un marcador de posición y nunca puede apuntar accidentalmente a un dominio que alguien más posee. Nunca dejes un dominio plausible pero no propio en los metadatos enviados.
Pon la instrucción de reemplazo en un comentario directamente encima del bloque y en el README del proyecto, y di cuántas ocurrencias hay. Normalmente son cuatro: canonical, og:url, og:image, twitter:image.