Page d'atterrissage Glyphe
Un sujet → une page. Le sujet boucle (un clip Kling épinglé de sorte que sa dernière image soit sa première) ; le shader le dessine sous forme de glyphes sur un fond animé. Sur la page :
- Héro : le curseur X sépare photo ← | → glyphes ; le curseur Y définit la taille de la grille ; un anneau et un viseur suivent le curseur. Le titre — un mot coupé en deux — est dessiné par le shader comme l'inverse d'un fond flou. Un dessin au trait dense, dont une partie suit le sujet.
- Sections : manifeste (un fait vrai avec un retournement), bandeau, quatre spécifications, un CTA de clôture sur le sujet à nouveau. Le défilement dissout la grille en gros pixels et inversement.
- Série : plusieurs pages partagent un moteur et un sélecteur de page ; chaque page obtient sa propre palette, son effet d'arrière-plan, son moteur de rendu de glyphes, ses polices, son dessin au trait et son texte.
assets/examples/pages/ contient cinq pages complètes qui montrent l'étendue (un astronaute sur un ciel nocturne, un coquelicot sur papier, le Mac de 1984 en plan technique, un nuage avec tramage et isobares, une méduse en braille néon). Lisez-en une ou deux avant d'écrire une page ; ne copiez jamais une page en bloc — chaque page est conçue sur mesure pour son sujet.
Ce dont vous avez besoin
| Besoin | Pourquoi | Comment |
|---|---|---|
| Un sujet | l'image de l'utilisateur, ou une description pour en générer une | demandez, ou prenez ce qu'ils ont donné |
FAL_KEY | images fixes, montages et vidéo | variable d'environnement sur chaque commande (FAL_KEY=… node …) ; ne l'affichez jamais et ne l'écrivez pas dans un fichier suivi. Uniquement si l'utilisateur demande à la stocker : un .env.local ignoré par git |
| Node 18+, ffmpeg, Python 3 | générateur, empaquetage, masques | node -v, ffmpeg -version, python3 -V ; macOS brew install node ffmpeg python |
Coût : les images fixes sont peu coûteuses (~0,15 $) ; chaque clip Kling de 15 s coûte sensiblement plus cher et nécessite souvent une nouvelle tentative — vérifiez les prix de fal et dites-le avant la première vidéo.
Étape 0 — Accord sur l'intention (un message court, puis décidez)
- Le sujet. Image personnelle → vérifiez-la (filigranes : ne les supprimez pas — demandez une copie sous licence ou générez une image originale à la place ; une photo d'une personne réelle → confirmez que c'est bien cette personne ou qu'elle a donné son consentement ; les produits de marque sont acceptables sur le plan éditorial, sans logos). Pas d'image → vous en générerez une ; proposez un sujet adapté à l'objectif de l'utilisateur.
- Le look. Si l'utilisateur en a décrit un, suivez-le. Sinon, choisissez vous-même les sept décisions dans
references/looks.mdet dites ce que vous avez choisi en une ou deux phrases. Si le projet a déjà des pages, faites en sorte que la nouvelle diffère de chaque page existante sur au moins cinq des sept points. - Mouvement. Ce qui doit bouger et à quel degré ("beaucoup de mouvement" vs "flottement calme") ; 15 s par défaut.
- Texte & cadrage. Ton, faits ou noms que l'utilisateur souhaite ; sinon une exposition / publication / événement fictif construit autour du sujet (
references/copy.md).
Étape 1 — Structure de base
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "Nom" --title "Premier/second" [--image path]
cd <project-dir>/tools && npm install
Le premier appel crée le projet (site/ avec engine.js, base.css, pages.json, index.html ; tools/ avec le pipeline ; .gitignore). Chaque appel ultérieur ajoute une page (site/<id>.html) et l'enregistre dans pages.json pour que le sélecteur de chaque page l'affiche.
Étape 2 — Invites → image fixe → révision
Écrivez tools/subjects/<id>.json (references/pipeline.md contient la liste de contrôle ; assets/examples/subjects/ les cinq qui ont fonctionné). Par défaut, utilisez un fond noir plat pur, le sujet à droite du centre avec un espace vide à gauche.
FAL_KEY=… node generate.mjs <id> still # à partir de l'invite "image"
FAL_KEY=… node generate.mjs <id> edit # ou : l'image de l'utilisateur sur un fond plat (original conservé)
Affichez tools/<id>.png. Itérez jusqu'à ce que l'utilisateur soit satisfait — tout ce qui suit en hérite.
Étape 3 — Clip → vérification → révision
FAL_KEY=… node generate.mjs <id> video # quelques minutes ; exécutez en arrière-plan
node generate.mjs <id> check # nombres de mouvement + tools/<id>-sheet.png
Lisez les nombres : en dessous d'environ 3 au milieu signifie qu'il bouge à peine — renforcez le libellé et régénérez avant de construire. Montrez la planche contact. Si l'utilisateur souhaite un mouvement différent, montrez-lui l'invite révisée avant de dépenser à nouveau.
Étape 4 — Construisez la boucle empaquetée
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # optionnel : chemins des parties lumineuses / à fort contraste pour les superpositions de suivi
Vérifiez une image de site/media/<id>-loop.mp4 : la moitié droite doit être une silhouette blanche nette. Ensuite, mesurez les positions que vous annoterez (references/pipeline.md → mesure).
Étape 5 — Concevez la page
Modifiez site/<id>.html (chaque marque EDIT), en utilisant references/looks.md pour les décisions,
references/shader-recipes.md pour le GLSL, et references/copy.md pour le texte :
- Les jetons
:rootet le lien Google Fonts. - Le shader :
field()(effet d'arrière-plan + halo),scene()(moteur de rendu de glyphes, plaque, couleur d'encre),photo(),main()(franges, inversion du titre, finition). Définissezstage({ focus, cell, zoom, atlas }). - Mots du titre, tailles et placement ; phrases de diffusion ; le logo / nom de la série.
- Travail au trait : SVG/DOM dense construit dans le script, animé ; éléments de suivi dans
onFrameviatoScreen(). - Sections : manifeste, bandeau, spécifications, CTA, pied de page — avec un style de section qui appartient à ce look.
- Téléphones : vérifiez le bloc
@media (max-width:760px)(taille du titre, taille du CTA, masquez les étiquettes encombrées).
Étape 6 — Aperçu et vérification
cd <project-dir> && python3 -m http.server 5180 -d site # ouvrez http://localhost:5180/<file>
Vérifiez dans un navigateur, pas en lisant le code : la console est propre ; le canvas apparaît ; déplacer le curseur sépare et redimensionne ; le titre est lisible sur les côtés photo et glyphes ; les superpositions se placent sur le sujet ; faites défiler chaque section ; un ordinateur de bureau large, une fenêtre presque carrée et un téléphone 375 px sans défilement horizontal. Rechargez à fond après les modifications (le serveur statique met en cache). references/troubleshooting.md couvre ce qui a déjà mal tourné.
Étape 7 — Remise
Dites à l'utilisateur ce que vous avez construit (sujet, mouvement, les sept décisions de look, le texte), tout ce que vous n'avez pas pu faire fonctionner, et les boutons qu'il est susceptible de modifier — constantes de franges, opacité de la plaque, plage de la grille, forces des blobs, taille du titre — avec l'endroit où chacun se trouve. Laissez les clips Kling bruts hors de git (.gitignore le fait déjà).
Ajouter une autre page
Exécutez à nouveau new_project.py <project-dir> <new-id> --name …, puis les étapes 2 à 6 pour cette page, en choisissant un look qui diffère des pages existantes.