Replicación de referencias
El ojo es bueno para detectar «algo está mal» pero malo para saber «cuánto está mal». Cuando la instrucción es «replícalo exactamente, sin errores», mide. Cada hora perdida ajustando un valor fue una hora que un solo script de extracción habría terminado.
Nunca confíes en los bordes de la captura de pantalla
Las capturas llegan con formato letterbox, con marco de dispositivo o con un cromo de navegador redondeado. Medir contra las dimensiones del archivo pone cada porcentaje ligeramente incorrecto, y el error es invisible porque todo está casi bien.
Encuentra primero la caja de contenido real:
from PIL import Image
import numpy as np
a = np.array(Image.open(src).convert('RGB')).astype(int).sum(axis=2)/3
rows = np.nonzero(a[:, 5] > 200)[0] # una columna que es fondo de página
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()
Expresa cada medición posterior como un porcentaje de esa caja, nunca del archivo.
Extrae posiciones, no las estimes
def bbox(x0, x1, y0, y1, lo, hi):
reg = a[y0:y1, x0:x1]
ys, xs = np.nonzero((reg >= lo) & (reg <= hi))
return x0+xs.min(), x0+xs.max(), y0+ys.min(), y0+ys.max()
Ventana cada elemento y umbraliza en su banda de luminancia — UI oscura sobre fondo claro, o viceversa. Dos precauciones:
- Un resultado que cae exactamente en el borde de tu ventana es una medición recortada, no un hallazgo. Amplía la ventana y vuelve a medir.
- El texto oscuro y una fotografía oscura pasan ambos un umbral «oscuro». Elige ventanas que contengan solo el elemento.
Convierte a porcentajes de la caja de contenido y construye con esos valores. Ahora «el titular es demasiado grande» se convierte en «el titular mide el 22.4% del ancho del panel en la referencia y el 32% en el mío».
Verifica una afirmación antes de construirla
Busca una característica dos veces antes de comprometerte. En una construcción, un par de líneas verticales finas fueron «vistas» en una miniatura e implementadas; la referencia no las tenía — era el borde de la silueta del sujeto. Una sola comprobación lo habría detectado:
band = a[60:330, :].mean(axis=0) # filas libres de otra UI
dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]
Fondo plano, sin caídas, sin líneas. Una regla de 1px aparece como una caída aislada de una sola columna; un borde fotográfico aparece como una rampa gradual. Son triviales de distinguir numéricamente y fáciles de confundir a simple vista.
Resuelve el encuadre de imágenes, no lo ajustes a ojo
Para reproducir cómo se recorta una fotografía, derívalo. Mide el ancho del sujeto como fracción de la foto, y de nuevo como fracción del panel:
escalaRender = anchoSujeto_enPanel / anchoSujeto_enFoto # p.ej. 1.231
Con object-fit: cover escalando por altura, anchoEscalado = anchoPanel × escalaRender, así que aspectoPanel = 1 / (escalaRender / aspectoFoto). Eso da la proporción del panel que usó el diseñador. Luego resuelve object-position desde el centro del sujeto — la fórmula está en ../landing-page/references/traps.md.
Haz una verificación de cordura con una cantidad independiente que no hayas ajustado, como la altura de la coronilla del sujeto. Si la predicción cae dentro de uno o dos píxeles, el modelo es correcto.
Reconoce cuándo una referencia no se puede igualar
A veces las matemáticas dicen que no. Si el object-position requerido cae fuera de 0–1, ningún valor coloca al sujeto ahí — hay que cambiar el aspecto del panel o la imagen.
Y si un recurso suministrado es una regeneración del original en lugar del original, sus proporciones diferirán. Detéctalo: predice una medida de la fuente y compárala. Coincidir al píxel en cuatro muestras significa la misma imagen; una discrepancia no uniforme (203px donde se predicen 282px, en un solo punto) significa un sujeto diferente.
Dilo claramente, indica qué está igualado — métricas de diseño, encuadre, colocación — y deja de perseguir el resto. Seguir «arreglándolo» produce peor resultado y desperdicia el tiempo del usuario.
Ambos viewports, siempre
Una referencia es una captura de escritorio y una captura de móvil. Construir solo escritorio e inferir móvil invierte la parte difícil — el móvil es donde caen las correcciones. Si solo se suministró una, pide la otra antes de empezar.
Ciclo de trabajo
- Extrae la caja de contenido; mide cada elemento en una tabla de porcentajes.
- Construye tokens y diseño con esos números.
- Renderiza en el aspecto de la referencia, escala la referencia a tu ancho, apílalos verticalmente con un divisor brillante. Apilado gana a lado a lado — el ojo sigue un borde vertical.
- Vuelve a medir tu render con el mismo script. Compara tablas, no impresiones.
- Repite por sección. No pases a una sección que esté visiblemente incorrecta.
Lista de verificación
- Caja de contenido extraída; porcentajes relativos a ella, no al archivo
- Ninguna medición posada en el borde de su ventana de búsqueda
- Cada «característica» confirmada numéricamente antes de implementar
- Encuadre de imagen resuelto, no ajustado a ojo
- Referencias de escritorio y móvil en mano
- Render vuelto a medir con el mismo script y comparado como números