Carte de vœux interactive
Créez une carte avec laquelle on aura envie de jouer : leur photo sur la couverture d'une carte pliée qui se balance dans la page, accroche une lumière mobile dans son foil ou sa peinture, s'ouvre d'un tapotement sur leur message en écriture manuscrite, et se retourne pour montrer son dos. Une courte construction transforme une image et quelques réglages en un seul fichier HTML contenant tout (image, police, moteur de rendu), qui s'ouvre directement depuis un fichier, fonctionne hors ligne et se place sur n'importe quel hébergeur web sans modification.
Ce que contient cette compétence :
scripts/make_card.pyconstruit la page à partir des données de la carte (JSON). Il vérifie les données et explique toute erreur avant d'écrire quoi que ce soit.scripts/grid.pydessine une grille de pixels étiquetée sur l'image, coupée exactement comme la carte la coupe, pour lire les positions (nécessaire uniquement pour les effets animés et les choix de couleurs).scripts/foil_preview.pymontre exactement ce qui devient du foil, en magenta, pour ajuster le foil avant la construction (nécessite numpy).scripts/snapshot.mjs(optionnel, nécessite Node et Playwright) prend des captures d'écran du recto, de l'intérieur et du dos, et avec--livemontre ce qui bouge sur une carte animée et ce que fait chaque tapotement.references/options.mdliste tous les réglages.references/living-cards.mdexplique comment faire vivre une carte. Lisez-les quand vous en avez besoin, pas avant.
Comment faire une carte
1. Obtenir l'image et le message
Les deux choses nécessaires de la personne sont l'image pour le recto et quoi écrire à l'intérieur. Si l'un manque, demandez-le, ou proposez d'écrire le message pour eux (demandez à qui c'est destiné, et de la part de qui). Tout le reste a une valeur par défaut raisonnable, donc ne leur faites pas remplir un questionnaire ; choisissez bien et mentionnez les choix effectués pour qu'ils puissent les modifier.
Prenez le message tel qu'il est donné. Ne polissez pas leurs mots sauf s'ils le demandent, mais insérez des sauts de ligne là où une carte manuscrite en aurait (un souhait sur sa propre ligne, la formule de politesse à la fin) ; une ligne trop longue pour la feuille se coupe automatiquement, à environ 20 lettres. Jusqu'à environ 60 mots, le texte est large et confortable ; les lettres plus longues sont écrites plus petites, et au-delà de ce qui tient, la fin est coupée, donc suggérez de raccourcir un message très long.
Plusieurs images donnent plusieurs cartes sur une même page, présentées l'une après l'autre avec un dock pour passer de l'une à l'autre. Cela convient à un ensemble de cartes, ou à une carte en plusieurs designs au choix.
2. Regarder l'image et choisir la finition
La finition détermine comment le recto accroche la lumière. Regardez l'image avant de choisir :
| L'image | Finition | Notes |
|---|---|---|
| Une peinture avec texture de pinceau (huile, gouache, acrylique, aquarelle épaisse) | paint | Les coups de pinceau se dressent et brillent sous la lumière. Si elle contient de la peinture dorée, faites-la briller aussi : foil.on: "colour" avec l'or sélectionné. |
| Une illustration, un dessin au trait, un lettrage ou un design plat, surtout sur papier uni | foil | on: "details" marque les lignes et les détails sombres en foil ; "colour" marque une couleur de votre choix (lettrage doré, par exemple) ; "darks" marque les formes les plus sombres (silhouettes). |
| Une photo | print | Imprimée sur carton mat. Un fin border en foil l'encadre joliment. Le foil sur les détails d'une photo a tendance à être bruyant. |
Couleurs de foil : gold (classique, chaud), silver (hiver, mariages, palettes froides), rose (romance),
copper (automne, rustique), pink (espiègle), holo ( holographique, anniversaires). Associez à la palette de l'image
et à l'occasion.
Vérifiez le foil avec foil_preview.py avant la construction (une fois les données de la carte écrites, étape 5). Ce
que vous vouliez voir en foil doit être solide, et rien d'autre ne doit être capturé. Deux choses nécessitent souvent une correction :
- Ce que vous voulez en foil partage sa couleur ou son obscurité avec des éléments que vous ne voulez pas, par exemple un lettrage doré
au-dessus de fleurs avec des centres dorés. Limitez le foil à une zone autour avec
foil.area. - L'or standard est pâle et classique. Une œuvre d'art dessinée dans un or beaucoup plus profond peut avoir sa propre encre, pour que le foil corresponde.
La section Foil de references/options.md décrit les encres, ce que amount fait dans chaque mode, et area.
Papier (l'intérieur, le dos et les bords) : white, cream, blush, sage, sky, midnight ou tout #rrggbb. Si l'image est dessinée sur du papier uni, la carte prend ce papier par défaut, ce qui donne généralement le meilleur résultat.
La carte est découpée au milieu de l'image selon sa forme : portrait (5:7, par défaut), square, landscape (7:5), ou original (la propre forme de l'image, dans certaines limites). Utilisez landscape pour les images larges. Si le sujet se trouve près d'un bord, exécutez grid.py pour voir ce que la découpe conserve.
3. Ajouter des effets pour l'occasion (optionnel)
Ceux-ci ne nécessitent pas de positions, donc ajoutez-les librement quand ils conviennent à la carte :
snow: des flocons dérivent sur le recto (hiver, Noël)hearts: de petits cœurs peints flottent de temps en temps au-dessus de l'image (amour, Saint-Valentin, fête des Mères, mariages)fireflies: des lumières douces errent dans la partie inférieure (nuits d'été, scènes rêveuses)shootingStars: une étoile filante traverse le haut de temps en temps (ciels nocturnes)sparkle: des points du foil accrochent la lumière et scintillent (toute carte en foil)
Un ou deux effets suffisent ; plus devient chargé.
4. Donner vie à la carte (optionnel, et la meilleure partie)
Une carte peut faire bien plus : la lanterne dans l'image brille, vacille et s'embrase lorsqu'on tapote, le
soleil projette des rayons, une queue de chat se balance et des cœurs s'élèvent lorsqu'on le caresse, les branches se balancent et perdent leur neige, les écharpes flottent dans la brise du pointeur. Cela nécessite des positions sur l'image, que vous lisez sur la grille de grid.py. Lisez references/living-cards.md et suivez-le.
Faites-le lorsque la personne demande que la carte soit vivante, animée ou interactive, ou lorsque l'image a des lumières évidentes (bougies, lanternes, le soleil, la lune, fenêtres éclairées) ou des personnages. Cela prend du temps, donc pour une carte rapide, proposez-le comme une prochaine étape.
5. Écrire les données de la carte
Enregistrez-les en JSON à côté de l'image. Une carte :
{
"title": "Joyeux anniversaire, Julie",
"image": "julie-anniversaire.jpg",
"alt": "Une aquarelle d'un renard dans un pré de coquelicots.",
"name": "Renard et Coquelicots",
"finish": "foil",
"foil": { "colour": "rose", "on": "details", "amount": 0.12 },
"paper": "cream",
"message": "Chère Julie,\nJoyeux anniversaire à ma personne préférée.\nÀ ta meilleure année !\nAvec tout mon amour, Nora",
"signature": ["Fabriqué avec amour par", "Nora"],
"effects": { "hearts": true, "sparkle": true }
}
alt décrit le recto pour les lecteurs d'écran ; écrivez-en toujours un. name apparaît au dos en petits caractères sauf si back ou signature indique le contraire. Plusieurs cartes sont placées dans "cards": [ {...}, {...} ], avec title et page en haut. Tous les réglages sont dans references/options.md.
6. Construire la carte
python scripts/make_card.py carte.json --check # vérifie les données, affiche la taille en pixels de la carte
python scripts/make_card.py carte.json -o carte.html
Les chemins dans le JSON sont relatifs au fichier JSON. Pour une carte rapide, il existe aussi une forme en une ligne :
python scripts/make_card.py --image recto.jpg --message "Joyeux anniversaire !" --finish foil --foil gold -o carte.html
Si le script signale une erreur, il dit ce qui ne va pas et comment le corriger. Les avertissements (message manquant, réglage inconnu, position hors carte) construisent quand même, mais corrigez-les.
7. Vérifier la carte
Si Node et Playwright sont disponibles, regardez la carte avant de la remettre :
node scripts/snapshot.mjs carte.html captures/
node scripts/snapshot.mjs carte.html captures/ --live # une carte animée : vérifie aussi ce qui bouge
Ceci écrit le recto, le recto avec la lumière maintenue dessus (front-lit : le foil ou la peinture
accrochant la lumière), l'intérieur et le dos en PNG. Regardez-les : le message est-il facile à lire,
le foil semble-t-il estampé plutôt que tacheté, la découpe de l'image est-elle là où vous l'attendiez ? Ajustez et
reconstruisez ; chaque itération est rapide. Sans navigateur, dites clairement que vous n'avez pas pu prévisualiser (l'aperçu du foil fonctionne toujours).
8. Remettre la carte
Donnez à la personne le fichier HTML et dites-lui comment l'utiliser :
- Ouvrez-le dans n'importe quel navigateur pour voir la carte. Tapotez-la (ou appuyez sur O) pour l'ouvrir ; faites-la glisser sur le côté (ou appuyez sur T) pour la retourner.
- Pour l'envoyer, mettez-la en ligne et partagez le lien : GitHub Pages, Netlify Drop ou tout hébergeur statique accepte le fichier tel quel. Ou envoyez le fichier lui-même ; il fonctionne hors ligne.
- Il pèse un à deux mégaoctets, presque entièrement pour l'image.
Mentionnez ce que vous avez choisi (finition, foil, papier, effets) en une phrase, afin qu'ils puissent demander des modifications.
Bon à savoir
- Les photos de téléphone sont redressées et les grandes images sont rétrécies (avec Pillow). Les zones transparentes deviennent blanches. Les photos HEIC doivent être converties en JPEG d'abord, à moins que Pillow ne puisse les lire.
- L'écriture manuscrite est Caveat, intégrée dans la page. Elle couvre le latin, le latin étendu et le cyrillique ; les autres écritures (vietnamien, grec, CJK) utilisent la police manuscrite par défaut de l'appareil.
- Sans WebGL, la page affiche toujours l'image et le message, à plat.
- La page est conçue en thème clair : la carte repose sur un fond blanc avec des ombres douces.
- Pour modifier l'apparence ou le comportement des cartes au-delà de ces réglages, le code source du moteur de rendu se trouve dans
le dépôt GitHub de la compétence (
renderer/), et sa reconstruction remplaceassets/greeting-card.js.