Réplication de référence
L'œil est bon pour détecter « quelque chose ne va pas » et peu fiable pour évaluer « de combien ça dévie ». Lorsque la consigne est « reproduisez-le exactement, sans erreur », mesurez. Chaque heure perdue à ajuster une valeur est une heure qu'un simple script d'extraction aurait économisée.
Ne jamais faire confiance aux bords de la capture d'écran
Les captures d'écran arrivent avec des bandes noires, des cadres d'appareil, ou un chrome de navigateur arrondi. Mesurer par rapport aux dimensions du fichier rend alors chaque pourcentage légèrement faux, et l'erreur est invisible car tout est presque correct.
Trouvez d'abord la vraie boîte de contenu :
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] # une colonne qui est le fond de page
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()
Exprimez chaque mesure ultérieure en pourcentage de cette boîte, jamais du fichier.
Extrayez les positions, ne les estimez pas
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()
Fenêtrage de chaque élément et seuillage sur sa bande de luminance — UI sombre sur fond clair, ou l'inverse. Deux précautions :
- Un résultat qui tombe exactement sur le bord de votre fenêtre est une mesure tronquée, pas une découverte. Élargissez la fenêtre et mesurez à nouveau.
- Un texte sombre et une photographie sombre passent tous deux un seuil « sombre ». Choisissez des fenêtres qui ne contiennent que l'élément.
Convertissez en pourcentages de la boîte de contenu et construisez sur ces bases. Désormais, « le titre est trop grand » devient « le titre fait 22,4 % de la largeur du panneau dans la référence et 32 % dans la mienne ».
Vérifiez une affirmation avant de la construire
Cherchez une fonctionnalité deux fois avant de vous engager. Sur un projet, une paire de lignes verticales fines a été « vue » dans une miniature et implémentée ; la référence n'en avait aucune — c'était le bord de la silhouette du sujet lui-même. Une seule vérification l'aurait détecté :
band = a[60:330, :].mean(axis=0) # lignes sans autre UI
dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]
Fond plat, pas de creux, pas de lignes. Une règle de 1px se manifeste par un creux isolé sur une colonne ; un bord photographique apparaît comme une pente progressive. Ils sont triviaux à distinguer numériquement et faciles à confondre à l'œil.
Résolvez le cadrage des images, ne le poussez pas
Pour reproduire la façon dont une photographie est recadrée, dérivez-la. Mesurez la largeur du sujet comme une fraction de la photo, et à nouveau comme une fraction du panneau :
renderScale = largeurSujet_dansPanneau / largeurSujet_dansPhoto # ex : 1.231
Avec object-fit: cover mis à l'échelle par hauteur, largeurAdaptee = largeurPanneau × renderScale, donc aspectPanneau = 1 / (renderScale / aspectPhoto). Cela donne la proportion de panneau utilisée par le designer. Ensuite, résolvez object-position à partir du centre du sujet — la formule est dans ../landing-page/references/traps.md.
Vérifiez avec une quantité indépendante que vous n'avez pas ajustée, comme la hauteur de la couronne du sujet. Si la prédiction tombe à un ou deux pixels près, le modèle est correct.
Sachez quand une référence ne peut pas être reproduite
Parfois, les maths disent non. Si le object-position requis tombe en dehors de 0–1, aucune valeur ne place le sujet là — l'aspect du panneau ou l'image doit changer.
Et si un actif fourni est une régénération de l'original plutôt que l'original lui-même, ses proportions seront différentes. Détectez-le : prédisez une mesure à partir de la source et comparez. Une correspondance au pixel près sur quatre échantillons signifie la même image ; un écart non uniforme (203 px là où 282 px sont prédits, à un seul endroit) signifie un sujet différent.
Dites-le clairement, indiquez ce qui est reproduit — métriques de mise en page, cadrage, placement — et arrêtez de courir après le reste. Continuer à « corriger » produit de moins bons résultats et fait perdre du temps à l'utilisateur.
Les deux fenêtres, toujours
Une référence est une capture d'écran desktop et une capture d'écran mobile. Construire uniquement le desktop et en déduire le mobile inverse la partie difficile — c'est sur mobile que les corrections atterrissent. Si une seule a été fournie, demandez l'autre avant de commencer.
Boucle de travail
- Extrayez la boîte de contenu ; mesurez chaque élément dans un tableau de pourcentages.
- Construisez les tokens et la mise en page selon ces nombres.
- Rendez à l'aspect de la référence, mettez la référence à l'échelle de votre largeur, empilez-les verticalement avec un séparateur lumineux. Empilé est meilleur que côte à côte — l'œil suit un bord vertical.
- Remesurez votre rendu avec le même script. Comparez les tableaux, pas les impressions.
- Répétez par section. Ne passez pas à une section qui est visiblement décalée.
Liste de vérification
- Boîte de contenu extraite ; pourcentages relatifs à celle-ci, pas au fichier
- Aucune mesure reposant sur le bord de sa fenêtre de recherche
- Chaque « fonctionnalité » confirmée numériquement avant d'être implémentée
- Cadrage de l'image résolu, pas poussé à l'œil
- Références desktop et mobile en main
- Rendu remesuré avec le même script et comparé sous forme de nombres