影片 → 滾動驅動登陸頁面
建立一個電影般的登陸頁面,其中的英雄區塊是隨滾動而非時間播放的影片 — 就像 Apple 產品頁面或 GitHub Copilot 登陸頁面。從原始影片中擷取幀,並在使用者滾動時切換顯示;在固定的英雄區塊下方,正常滾動的區塊承載文案與行動呼籲按鈕。
何時呼叫
- 使用者提供影片並要求登陸頁面、滾動網站、滾動幀英雄或從影片建立網站
- 提及「Apple 風格滾動」、「GitHub Copilot 登陸頁面」、「滾動擦拭」、「滾動時顯示幀」
- 希伯來文對應:"דף נחיתה מסרטון", "אתר עם גלילה", "סרטון בגלילה"
儲存位置
預設: ~/Documents/yuv-projects/landings/<slug>/ — 一律將登陸頁面儲存在此處,以便日後查找。若父目錄不存在,請建立它。
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 在此處建立 <slug>/。
最終路徑:~/Documents/yuv-projects/landings/<slug>/。每次建置完成時,告知使用者登陸頁面的存放位置。
工作流程(8 個步驟)
- 分析原始影片 — 使用
ffprobe取得時長、幀率、解析度、音訊資訊。 - 選擇幀數 — 預設
80。下限40(低於此會卡頓),上限160(頁面過重)。根據時長選擇:≤10 秒 → 50,10–30 秒 → 80,30–60 秒 → 120,>60 秒 → 160。 - 決定輸出目錄 — 預設
~/Documents/yuv-projects/landings/<slug>/。<slug>應簡短,從影片名稱或主題衍生。僅在明確要求時覆蓋。 - 擷取幀 — 執行
references/extract-frames.py <原始影片> <輸出目錄> [幀數]。輸出爲輸出目錄/frames/f_0001.jpg……,統一使用 JPG 品質 82 且最大寬度 1920(若原始解析度更大則縮小)。 - 複製並自訂
references/landing-template.html到輸出目錄/index.html:- 將
__FRAMES__佔位符替換為每個幀的<img>標籤(當你傳遞--build-html時,建置腳本會自動處理)。 - 填入
__HEADLINE__、__TAGLINE__、__CTA_TEXT__、__CTA_HREF__、各區塊內容。 - 對於希伯來文內容:設定
<html lang="he" dir="rtl">並將字型切換為 Rubik/Assistant(參見references/design-notes.md)。
- 將
- 最佳化幀 — 建置腳本已將最大寬度縮放至 1920px。若頁面總大小超過 12 MB,將品質降至 75 或減少幀數。
- 預覽 — 在輸出目錄內執行
python -m http.server並開啟http://localhost:8000。在效能良好的機器上,滾動體驗應流暢順滑。 - 部署 — 將資料夾丟到 Vercel/Netlify/Cloudflare Pages 上。無需建置步驟。
滾動機制
- 外部滾動容器
.scroll-stage的高度設爲視口單位(預設600vh= 滾動 5 個螢幕以遍歷所有幀)。 - 固定英雄區塊
position: sticky; top: 0; height: 100vh,包含所有絕對定位且隱藏(僅顯示活動幀)的幀。 - 滾動監聽器計算
progress = scrolledIntoStage / scrollableHeight,範圍限制在 0–1 之間。 idx = floor(progress * (N - 1))— 將.active類別切換到該幀。- 將監聽器包裹在
requestAnimationFrame中以保持 60fps。
設計規則
- 如果專案是 YUV.AI 品牌相關(Yuval 本人、他的作品集、他的品牌):呼叫
yuv-design-system並根據媒介鎖定模式 —- Neon 模式(YUV.AI 網站的預設值):熱粉紅 (
#FF1464) + 霓虹青 (#00E5FF) + 白色或濃黑色背景。Anton + Inter(英文)/ Rubik + Assistant(希伯來文)。邊框半徑 0px 或 999px。 - 溫暖編輯模式:僅限 Hope、Marcus、bigcats.ai、practical.yuv.ai — 粉紅 + 黃色 + 骨色,米白色絕不使用純
#fff。 - 絕不在登陸頁面上使用 Decks 模式(Fly High 紫色/黃色) — 該調色板僅保留給簡報投影片。
- Neon 模式(YUV.AI 網站的預設值):熱粉紅 (
- 如果專案非 YUV.AI 品牌相關:不要套用 yuv-design-system。根據原始影片的情緒選擇合適的調色板。Anton + Inter 仍然是合理的預設值,但非強制。
- 英雄區塊的疊加層應微妙 — 一個暗角效果和一個大標題;不要讓畫面淹沒。
- 英雄區塊下方的區塊:淺色背景(Neon 模式下為白色,溫暖編輯模式下為米白色,一般溫暖風格則為骨色),大的 Anton 標題,正文使用 Inter 字型 18–22px,行動呼籲按鈕為尖銳藥丸形狀 (
border-radius: 999px) — Neon 模式下為粉紅色填充,其他情況使用與品牌相符的顏色。 - 對於希伯來文:遵循 RTL,標題使用 Rubik 900,正文使用 Assistant 400/500。
檔案參考
| 檔案 | 用途 |
|---|---|
references/extract-frames.py | 基於 ffmpeg 的幀擷取工具;可選一次建置完成完整的 HTML |
references/landing-template.html | 包含滾動機制的自足登陸頁面骨架 |
references/design-notes.md | 字型、調色板和動畫預設值 |