Glyph 랜딩 페이지
하나의 주제 → 하나의 페이지. 주제는 루프됩니다(마지막 프레임이 첫 프레임과 연결되도록 고정된 Kling 클립). 셰이더는 이를 애니메이션 배경 위에 글리프(glyphs)로 그립니다. 페이지에는:
- Hero: 커서 X는 사진 ← | → 글리프를 나누고, 커서 Y는 그리드 크기를 설정합니다. 링과 십자선이 커서를 따라다닙니다. 제목(한 단어를 둘로 나눈 것)은 셰이더가 흐릿한 배경의 반전으로 그립니다. 조밀한 선화(line art) 중 일부는 주제를 추적합니다.
- 섹션: 선언문(전환점이 있는 실제 사실), 마키(marquee), 네 가지 사양, 주제를 다시 보여주는 마무리 CTA. 스크롤하면 그리드가 큰 픽셀로 녹았다가 다시 돌아옵니다.
- 시리즈: 여러 페이지가 하나의 엔진과 페이지 전환기를 공유합니다. 각 페이지는 고유한 팔레트, 배경 효과, 글리프 렌더러, 폰트, 선화 및 텍스트를 가집니다.
assets/examples/pages/에는 다섯 개의 완전한 페이지가 있어 범위를 보여줍니다(밤하늘의 우주비행사, 종이 위의 양귀비, 청사진으로서의 1984년 Mac, 하프톤과 등압선이 있는 구름, 네온 점자 속 해파리). 페이지를 작성하기 전에 한두 개를 읽어보세요. 절대 그대로 복사하지 마세요. 각 페이지는 해당 주제에 맞게 새롭게 설계됩니다.
필요한 것
| 필요 항목 | 이유 | 방법 |
|---|---|---|
| 주제 | 사용자의 이미지 또는 주제를 생성할 설명 | 묻거나, 제공된 내용 활용 |
FAL_KEY | 스틸, 편집 및 비디오 | 각 명령어에 환경 변수로 설정(FAL_KEY=… node …); 절대 출력하거나 추적된 파일에 기록 금지. 사용자가 저장을 요청한 경우에만: .gitignore에 포함된 .env.local 파일 사용 |
| Node 18+, ffmpeg, Python 3 | 생성기, 패킹, 마스크 | node -v, ffmpeg -version, python3 -V; macOS brew install node ffmpeg python |
비용: 스틸은 저렴합니다(~$0.15). 각 15초 Kling 클립은 눈에 띄게 더 비싸며 종종 한 번의 재시도가 필요합니다. 첫 번째 비디오 전에 fal 가격을 확인하고 알려주세요.
0단계 — 의도 합의 (짧은 메시지 하나로 결정)
- 주제. 직접 이미지를 제공한다면 확인하세요(워터마크: 제거하지 말고 라이선스 사본을 요청하거나 대신 원본을 생성하세요. 실존 인물의 사진 → 본인인지 또는 동의를 얻었는지 확인. 상표 제품은 로고 없이 편집적으로 사용 가능). 이미지가 없으면 사용자가 직접 생성할 것입니다. 사용자의 목표에 맞는 주제를 제안하세요.
- 룩(Look). 사용자가 설명했다면 따르세요. 그렇지 않으면
references/looks.md에 있는 일곱 가지 결정을 직접 선택하고 한두 문장으로 선택한 내용을 말하세요. 프로젝트에 이미 페이지가 있다면 새 페이지가 기존 페이지와 최소 다섯 가지 항목에서 달라야 합니다. - 모션. 무엇이 어떻게 움직일지("많은 움직임" vs "잔잔한 부유"); 기본값 15초.
- 텍스트 및 프레이밍. 어조, 사용자가 원하는 사실이나 이름; 기본값은 주제를 중심으로 한 가상의 전시회/출판물/이벤트(
references/copy.md).
1단계 — 스캐폴드
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "Name" --title "First/second" [--image path]
cd <project-dir>/tools && npm install
첫 번째 호출은 프로젝트를 생성합니다(site/에 engine.js, base.css, pages.json, index.html; tools/에 파이프라인; .gitignore). 이후 호출은 페이지를 추가합니다(site/<id>.html)하고 pages.json에 등록하여 모든 페이지의 전환기가 이를 표시하게 합니다.
2단계 — 프롬프트 → 스틸 → 검토
tools/subjects/<id>.json 작성 (references/pipeline.md에 체크리스트가 있습니다. assets/examples/subjects/에는 작동한 다섯 가지 예시). 기본값은 평평한 순수 검정 배경, 오른쪽 중앙에 주제, 왼쪽에 빈 공간.
FAL_KEY=… node generate.mjs <id> still # "image" 프롬프트에서
FAL_KEY=… node generate.mjs <id> edit # 또는: 사용자 이미지를 평평한 배경 위에 (원본 유지)
tools/<id>.png를 보여주세요. 사용자가 만족할 때까지 반복하세요. 이후 모든 작업이 이 결과를 기반으로 합니다.
3단계 — 클립 → 확인 → 검토
FAL_KEY=… node generate.mjs <id> video # 몇 분 소요; 백그라운드에서 실행
node generate.mjs <id> check # 모션 번호 + tools/<id>-sheet.png
숫자를 읽으세요. 중간 지점에서 ~3 미만이면 거의 움직이지 않는 것입니다. 빌드하기 전에 표현을 강화하고 다시 생성하세요. 콘택트 시트(contact sheet)를 보여주세요. 사용자가 다른 모션을 원하면 다시 지출하기 전에 수정된 프롬프트를 보여주세요.
4단계 — 압축된 루프 빌드
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # 선택 사항: 오버레이 추적용 빛나는/고대비 부분의 경로
site/media/<id>-loop.mp4의 한 프레임 확인: 오른쪽 절반은 깨끗한 흰색 실루엣이어야 합니다. 그런 다음 주석을 달 위치를 측정하세요(references/pipeline.md → 측정).
5단계 — 페이지 디자인
site/<id>.html 편집 (모든 EDIT 마커), references/looks.md를 참조하여 결정, references/shader-recipes.md를 참조하여 GLSL, references/copy.md를 참조하여 문구:
:root토큰과 Google Fonts 링크.- 셰이더:
field()(배경 효과 + 후광),scene()(글리프 렌더러, 판, 잉크 색상),photo(),main()(가장자리 번짐, 제목 반전, 마무리).stage({ focus, cell, zoom, atlas })설정. - 제목 단어, 크기 및 배치; 퍼진 문장; 로고/시리즈 이름.
- 선 작업: 스크립트로 작성된 밀집된 SVG/DOM, 애니메이션;
onFrame에서toScreen()을 통한 추적 요소. - 섹션: 선언문, 마키, 사양, CTA, 바닥글 — 이 룩에 속하는 섹션 스타일링 포함.
- 휴대폰:
@media (max-width:760px)블록 확인 (제목 크기, CTA 크기, 혼잡한 레이블 숨기기).
6단계 — 미리보기 및 확인
cd <project-dir> && python3 -m http.server 5180 -d site # http://localhost:5180/<file> 열기
코드를 읽지 않고 브라우저에서 확인: 콘솔 깨끗함; 캔버스 표시됨; 커서 이동으로 분할 및 크기 조절; 사진 및 글리프 측에서 제목 읽기 쉬움; 오버레이가 주제 위에 위치; 모든 섹션 스크롤; 넓은 데스크탑, 거의 정사각형 창, 가로 스크롤 없는 375px 휴대폰. 편집 후 강제 새로고침(정적 서버 캐시 있음). references/troubleshooting.md에는 이전에 발생한 문제들이 다루어져 있습니다.
7단계 — 인계
사용자에게 구축한 내용(주제, 모션, 일곱 가지 룩 결정, 텍스트), 작동하지 않은 부분, 그리고 사용자가 조정할 가능성이 있는 조절 장치 (가장자리 번짐 상수, 판 불투명도, 그리드 범위, 블롭 강도, 제목 크기)와 각각의 위치를 알려주세요. 원시 Kling 클립은 git에서 제외하세요(.gitignore가 이미 처리함).
다른 페이지 추가
new_project.py <project-dir> <new-id> --name …을 다시 실행한 후 해당 페이지에 대해 2~6단계를 수행하되, 기존 페이지와 다른 룩을 선택하세요.