影片 → 捲動驅動登陸頁面
建立一個電影感的登陸頁面,其英雄區的影片是透過 捲動 而非時間來播放——類似 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 <source-video> <output-dir> [count]。輸出至output-dir/frames/f_0001.jpg… 統一使用 JPG 品質 82,最大寬度 1920(若來源較大則縮小)。 - 複製並客製化
references/landing-template.html到output-dir/index.html:- 將
__FRAMES__佔位符替換為每個影格的<img>標籤(建置腳本在傳入--build-html參數時會自動執行此操作)。 - 填入
__HEADLINE__、__TAGLINE__、__CTA_TEXT__、__CTA_HREF__及各區段內容。 - 對於希伯來語內容:設定
<html lang="he" dir="rtl">並將字型切換為 Rubik/Assistant(參閱references/design-notes.md)。
- 將
- 最佳化影格 — 建置腳本已將尺寸縮放至最大寬度 1920 像素。若頁面總體積超過 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並根據媒介鎖定模式——- 霓虹模式(YUV.AI 網站的預設值):亮粉紅(
#FF1464)+ 霓虹青(#00E5FF)+ 白色或深黑色畫布。Anton + Inter(英文)/ Rubik + Assistant(希伯來文)。圓角為 0px 或 999px。 - 溫暖編輯模式:僅限於 Hope、Marcus、bigcats.ai、practical.yuv.ai — 粉紅 + 黃色 + 骨色,不使用純白
#fff。 - 絕不使用 Decks 模式(Fly High 紫/黃色) 於登陸頁面——該調色盤僅保留給投影片使用。
- 霓虹模式(YUV.AI 網站的預設值):亮粉紅(
- 如果專案非 YUV.AI 品牌相關:不要套用
yuv-design-system。選擇符合來源影片氛圍的調色盤。Anton + Inter 仍是合理的預設字型,但非強制。 - 英雄區的覆蓋層應低調——一個暗角效果和一個大標題;不要淹沒影格。
- 英雄區下方的區塊:淺色畫布(霓虹模式為白色,溫暖編輯模式為米白色,一般溫暖風格則為骨色),大標題使用 Anton 字型,正文使用 Inter 字型,大小 18–22px,行動呼籲按鈕設計為銳利藥丸形狀(
border-radius: 999px)——霓虹模式中為粉紅色填充,其他情況則使用品牌合適的顏色。 - 對於希伯來語:遵循 RTL,標題使用 Rubik 900,正文使用 Assistant 400/500。
檔案參考
| 檔案 | 用途 |
|---|---|
references/extract-frames.py | 基於 ffmpeg 的影格提取器;可選擇在一次執行中建置完整的 HTML |
references/landing-template.html | 包含滾動機制的自包含登陸頁面骨架 |
references/design-notes.md | 排版、調色盤和動畫預設值 |