啟動品牌
每個啟動影片從 brand/brand.json 讀取其外觀。此技能可從讀者自己的網站建立該檔案,進行檢查,然後交給 launch-film。每個品牌執行一次,當網站外觀改變時再執行一次。
1. 萃取
npm install # 一次:puppeteer 及其 Chrome
node tools/brand-from-url.mjs https://your-site.com --out brand
它會以 1920x1080 解析度打開頁面,關閉 Cookie 橫幅,滾動一次以載入延遲內容,然後寫入:
| 檔案 | 內容 |
|---|---|
brand.json | 影片使用的角色。這是影片唯一讀取的檔案。 |
evidence.json | 每個角色決定的依據:計算樣式、CSS 色彩變數、像素直方圖、按鈕和連結顏色、字型、每個 Logo 候選及其評分和原因。 |
logo.svg 或 logo.png | 適用於淺色背景的 Logo。logo-on-dark.* 用於深色背景,mark.svg 用於可分離的圖示標誌。 |
fonts/ | 頁面實際載入的顯示字型和內文字型檔案(當頁面未提供 Google Fonts 時,會從 css2 API 獲取)。 |
screens/hero.png, screens/full.png | 第一個視窗畫面及完整頁面(上限 6000 px)。 |
images/ | 最大的內容圖片,通常是產品照。 |
preview.png | 一張圖表:Logo 在淺色和深色背景上、每個色彩角色、顯示字型搭配強調色、深色英雄卡片、強調按鈕。 |
標誌:--no-fonts 跳過字型檔案,--max-images 0 跳過圖片。本地頁面也可運作
(node tools/brand-from-url.mjs ./site/index.html)。手動編輯 brand.json 後,使用
node tools/brand-from-url.mjs --preview --out brand 重新渲染圖表。
2. 審閱(切勿跳過)
並排閱讀 preview.png 和 screens/hero.png。這些角色是啟發式的;圖表會在 10 秒內顯示它們是否選對了。按以下順序檢查:
- Logo 在淺色和深色背景上。 兩者都必須可讀。在深色背景上消失的 Logo 需要一個淺色版本:向讀者索取他們檔案,或編輯
logo-on-dark.svg內的顏色。 - 強調色。 應該是大家聯想到品牌的顏色,通常是主要按鈕。
evidence.json列出accent_candidates及其票數。如果它選中了英雄插圖顏色或狀態顏色,請換上正確的十六進位碼。 - 背景色和墨水色。 陳述場景位於
ground上,使用ink類型。它們必須符合網站的感覺(暖色米白、純白、淺色紙張色調)。 - 深色。 英雄卡片使用
dark。它看起來應該像品牌自己的深色區塊,而不是隨機的近黑色。如果網站沒有深色區塊,工具會加深強調色;檢查它是否符合預期。 - 字型。 顯示字型必須在圖表的英雄文字中渲染。
evidence.json中的fonts顯示找到哪些檔案。 - 名稱和標語。 標語位於組合標誌的名稱下方:2 到 8 個字,使用網站自己的詞語。
直接在 brand.json 中修正錯誤的值,重新渲染預覽,向讀者展示,然後才將 "reviewed": true 標記爲已審閱。在回覆中用一行記錄任何手動更改的內容。
每個角色在影片中的作用
| 角色 | 用途 |
|---|---|
ground | 每個陳述場景、產品導覽地板、結尾組合標誌。 |
surface | 地面上的卡片、晶片和視窗。 |
ink, ink_secondary | 淺色背景上的英雄文字和輔助文字。 |
accent | 節制使用:每個場景一個元素(按鈕按下、開關、完成狀態)。除非簡報要求強調英雄卡片,否則永遠不要用於整個地面。 |
accent_ink | 強調色上的文字。 |
dark, dark_ink | 硬切英雄卡片、深色時刻。 |
accent_on_dark | 深色卡片上的關鍵詞(強調色變亮至可讀;單色品牌使用 dark_ink)。 |
highlight | 每行 1 或 2 個關鍵詞後的柔和標記,從不超過。 |
success, danger | 勾選、完成狀態、罕見的失敗詞。 |
fonts.display | 英雄文字(字重和字距來自網站的 h1)。 |
fonts.body | 輔助行、UI 晶片。 |
logo, name, tagline, domain | 剪輯上的名稱節拍和結尾組合標誌。 |
copy | 劇本用的詞語。影片說網站的語言;launch-story 從 copy.h1、copy.subhead、copy.h2 和 copy.features 開始。 |
images | 候選產品照。來自讀者的真實產品螢幕截圖或錄影勝過任何抓取的圖片。 |
應變機制
- 未找到 Logo。 工具會退回到網站圖示並告知。向讀者索取 SVG(最佳)或寬度至少 1000 px 的透明 PNG;將其放入
brand/並將logo.file指向它。 - 深色模式網站。
mode為dark。頁面的背景成為dark,並從中推導出ground和ink用於淺色陳述場景。如果品牌也想要深色陳述場景,請手動交換ground和dark(以及ink和dark_ink)。 - 單色品牌。 沒有飽和顏色獲得票數,因此
accent是主要按鈕顏色(通常是黑色),highlight是淺灰色。詢問讀者是否有標誌性顏色;如果沒有,保持單色,讓字型和動態來承擔影片。 - 網路字型無法下載。 某些字型廠商封鎖直接下載。在本機安裝該字型(影片會依家族名稱回退至已安裝字型)或從 Google Fonts 選取最接近的開放字型並將其檔案放入
brand/fonts/。 - 字型授權。 網路授權不一定涵蓋影片。在影片發布前,確認顯示字型和內文字型已獲影片或動態使用授權,或使用開放(OFL)字型。
- 讀者有品牌指南。 以他們的指南為準。手動將值輸入到
brand.json(保留相同鍵),將 Logo 檔案放入brand/,重新渲染預覽並標記為已審閱。 - 網站封鎖無頭瀏覽器。 從一般瀏覽器儲存頁面(檔案,另存頁面,完整),然後對儲存的 HTML 檔案執行工具。
交接
launch-film 在構建時讀取 brand/brand.json。基於 "reviewed": false 構建的影片是草稿;在展示時請說明。