動畫Email簽名檔 是做什麼的?
你要為使用者的品牌建立兩項資源,並放到他們的網站上:
- 一個循環GIF(1200×340,顯示為480×136,約11秒,小於1 MB)。它從品牌卡片(Logo、名稱、標語、網域)開始,展示產品執行一項真實任務,然後回到品牌卡片。
- 一個團隊頁面,讓每位成員輸入姓名、職稱和Email,在淺色與深色收件匣預覽中查看簽名檔,並複製它。姓名與職稱保持為即時文字,因此一個GIF可供整個團隊使用。頁面會告訴搜尋引擎與AI爬蟲不要索引。
技能資料夾包含:
scripts/inspect-site.mjs:讀取網站(頁面、顏色、字型、Logo、圖片、截圖)assets/card.html:動畫,包含三個場景(對話、計數器、展示),由brand.json填入內容assets/signature-page.html:團隊頁面assets/brand.example.json:範例品牌資料,供複製使用scripts/render.mjs:卡片 → GIF,包含大小與循環檢查scripts/build-page.mjs:brand.json → 團隊頁面references/deploy.md:將兩項資源部署到網站;請在第6步閱讀
為什麼這樣設計
了解以下幾點,能讓你在品牌不符合模板時做出正確的判斷:
- Email無法執行程式碼。 Gmail、Outlook和Apple Mail會移除簽名檔中的腳本、影片和CSS動畫,因此唯一能在所有郵件客戶端中正常運作的動態效果就是動畫GIF。
- 舊版桌面Outlook只顯示第一幀。 因此第0幀必須是完成的品牌卡片,絕不能是空白或半完成的幀。循環也必須精確結束在那張卡片上,這樣重新開始時才不會有明顯的跳動。
render.mjs會檢查這兩點。 - 檔案大小很重要。 大型簽名檔會被截斷或載入緩慢,因此請將GIF保持在1 MB以下。GIF只儲存幀之間變化的像素,因此任何大範圍區域的變化都會讓檔案急遽膨脹。在一個實際案例中,Logo後方輕微脈動的光芒讓GIF從434 KB增加到1.26 MB。建議將動畫限制在小區域:打字文字、圖示、短暫淡出。
render.mjs會在超過1 MB時回報錯誤。 - 以2倍解析度繪製,以固定大小顯示。 這樣在Retina螢幕上才能保持清晰。簽名檔HTML設定
width="480" height="136",讓郵件應用程式永遠不會以1200 px的原始寬度顯示。 - 複製的簽名檔必須指向GIF的絕對HTTPS位址。 郵件應用程式無法載入本地檔案或相對路徑。頁面永遠複製
gifUrl,即使在預覽本地檔案時也是如此。 - 姓名沒有自己的顏色。 它會採用收件匣的文字顏色,因此在淺色與深色模式中都能閱讀。第二行和Email連結使用中間色調,在兩種模式中都能清晰顯示。
- 故事只展示產品的真實功能。 簽名檔會觸及客戶與投資人,因此其中任何虛構的功能或數字,都會讓團隊寄出的每一封Email變成虛假陳述。請從產品自己的網站或文件中獲取故事,並在使用者同意後才進行渲染。
步驟
1. 建立工作資料夾
使用網站儲存庫外的資料夾,以免工具程式混入他們的網站:
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
用 ffmpeg -version 檢查ffmpeg。安裝方式:macOS使用 brew install ffmpeg,Windows使用 winget install Gyan.FFmpeg,Linux使用 sudo apt install ffmpeg。
從這個資料夾執行以下所有指令。brand.json、網站摘要、任何裁切後的圖片以及輸出檔案都放在這裡,與 node_modules 在同一層。
2. 讀取網站
node <技能資料夾>/scripts/inspect-site.mjs https://他們的網站.com 網站摘要 --pages 6
它會開啟首頁以及最多6個其他頁面(優先找產品、功能、關於、定價),並寫入 網站摘要/ 資料夾:
brief.json:pages[]包含每個頁面的標題、描述、標題、主要文字和按鈕標籤,以及其palette(實際使用的RGB顏色,依覆蓋頁面面積排序,分為background、text、button、link)和fonts。頂層的logos和images列出候選項目。空的button列表或system-ui字型表示網站沒有提供這些資訊:請從截圖中取出強調色,並用肉眼選擇字型。screens/:每個頁面的截圖logos/:每個Logo候選項目(頁首SVG或圖片、應用程式圖示、社群圖片)images/:最大的內容圖片(產品、料理、專案、應用程式截圖、人物)
brief.json → logos 和 images 會列出每個檔案的像素大小(px),並在圖片對於卡片或寬橫幅來說太小時加上 note。
如果它只讀取到一個頁面,可能是因為該網站使用腳本建構連結,或封鎖自動化訪問。請改用產品頁面作為起始URL重新執行,或詢問使用者。
然後實際檢查,就像設計師在開始前會做的那樣:
- 截圖: 開啟首頁和一兩個產品頁面的截圖。感受風格(深色或淺色、有趣或嚴肅、照片風格或扁平UI),以及哪個顏色是品牌強調色。最常使用的按鈕背景色通常就是強調色。
- Logo: 開啟Logo候選項目。
- 頁首SVG通常是最好的來源。
apple-touch-icon可能是乾淨的方形標記,但請檢查其px:許多網站提供32×32的圖示,在卡片上會模糊。任何標註「對卡片來說太小」的都不適用。 - 檢查你有哪些。方形標記放在
logo。橫向文字標記放在wordmark,它會在品牌卡片上取代輸入的名稱。 - 如果沒有方形Logo,卡片會自動調整。如果有文字標記,它會移除左欄,避免名稱顯示兩次。如果兩者都沒有,它會用強調色繪製品牌名稱的第一個字母。
- 不要使用小於64 px的網站圖示或模糊的裁切:請向使用者索取檔案。
- 為白色頁首設計的Logo可能會在深色卡片上消失。如果發生這種情況,請使用淺色卡片、索取淺色版本,或編輯SVG的
fill屬性。
- 頁首SVG通常是最好的來源。
- 圖片: 開啟展示場景的候選圖片。跳過看起來像圖庫的照片、人臉(先詢問),以及任何包含在168×126解析度下無法閱讀的小文字圖片。
- 幀會裁切填滿(約4:3)。寬螢幕英雄橫幅通常已經內嵌文字和按鈕,裁切它們會留下字母殘片。請先自行裁切主體:
這裡的ffmpeg -i 網站摘要/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:y會圍繞產品選取一個4:3的區域。然後開啟結果檢查。
- 幀會裁切填滿(約4:3)。寬螢幕英雄橫幅通常已經內嵌文字和按鈕,裁切它們會留下字母殘片。請先自行裁切主體:
- 文字: 閱讀主要文字和標題。了解這家企業真正為客戶做了什麼,用他們自己的話語,以及任何公開陳述的真實數據(服務過的客戶、配送的訂單、經營年數)。
如果網站封鎖腳本(登入牆、機器人保護)或內容很少,請向使用者索取Logo、顏色以及一句描述企業業務的話。
3. 選擇場景並撰寫故事,然後取得批准
brand.json → story.type 從三個場景中選擇一個。選擇最能直接展示這家企業如何完成其工作的場景:
| 場景 | 適合 | 故事欄位 |
|---|---|---|
chat | 軟體、AI代理、應用程式、提供解答或修復服務的服務 | question(≤ 32 字元),三個 steps 為 { text ≤ 34, status: "ok" | "warn" },result(≤ 28),details(2-3 行 ≤ 40) |
counter | 一個真實的公開數字:經手的資金、配送的訂單、服務的客戶、經營的年數 | label(≤ 40),value(數字),prefix/suffix(例如 "₹"、"+"、" 訂單"),decimals,result(≤ 28),details |
showcase | 商店、美食、旅遊、工作室、作品集、實體產品:任何展示比文字更好的事物 | items:2-3 個 { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }。照片是GIF中最重的部分:測試中,2張照片約790 KB,3張約940 KB,4張會超過1 MB。 |
計數器的數字必須是企業已經公開陳述的(在其自己的網站上),並經過使用者同意。絕對不能虛構。展示場景使用企業自己網站上的圖片,而不是圖庫。
要添加不同的場景(例如前後對比、地圖釘路線、進度條),請在 card.html 的副本中向 SCENES 添加項目,並使用 --card your-card.html 進行渲染。請遵守「為什麼這樣設計」中的規則。
撰寫 brand.json(複製 assets/brand.example.json;圖片路徑相對於 brand.json):
- Name、Domain、URLs:
name、domain、siteUrl以及gifUrl,即GIF將存放的絕對位址(例如https://their-site.com/email/signature.gif)。 - Text:
tagline,大約五個字說明企業業務。可選email,團隊頁面上顯示的預設Email。 - Images:
logo(方形標記,可選)和wordmark(可選)。 - Fonts: Google Fonts 系列名稱。
brief.json列出了網站自己的字型。- 如果那些字型在Google Fonts上,請使用它們。
- 如果是專有或自託管字型,請依感覺選擇最接近的Google Font:圓潤無襯線配圓潤無襯線,襯線配襯線。
- 省略
fonts以使用系統字型。
- Colours:
colors,從網站的色板構建:bg:卡片背景。品牌的深色調在淺色收件匣中閱讀效果良好,在深色收件匣中也不會刺眼。如果網站是淺色調,淺色卡片也可以。card:略為不同的面板顏色line:邊框text、muted和subtle:文字顏色,從最強到最弱。它們需要在bg上有清晰的對比。accent:品牌顏色good和bad:綠色和紅色link:一個在白色收件匣上足夠深的強調色,以便閱讀
將 story.type 設定為你選擇的場景;預設為 chat。
在渲染之前向使用者展示計畫,並等待他們的批准。包括場景、故事內容(或選擇的圖片與說明),以及你將使用的Logo。
4. 渲染並檢查
node <技能資料夾>/scripts/render.mjs brand.json signature.gif
它會印出大小和 PASS 行,寫入 signature-last.png(循環結束的幀,必須與第一幀相符),在文字超出邊緣、檔案超過1 MB或循環未在第一幀結束時回報錯誤,並寫入 signature-first.png,這是舊版Outlook會顯示的幀。開啟那張圖片以及兩三張循環中間的幀,並檢查:
- 右邊緣沒有被截斷(長文字是常見原因)
- Logo清晰
- 顏色可讀
- 第一幀是完成的卡片
若要提取例如第5秒的幀,執行 ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png。修正並重新渲染,直到通過檢查且看起來正確。如果超過1 MB,請先移除大範圍的動畫。降低 --fps 12 是最後的手段。
在繼續下一步之前,向使用者展示第一幀和一個中間幀(或GIF本身)。
5. 建立團隊頁面
node <技能資料夾>/scripts/build-page.mjs brand.json email-signature.html
要在部署前預覽,請在工作資料夾中執行 npx serve .,然後開啟 http://localhost:3000/email-signature?preview=signature.gif。省略 .html:serve 會重新導向 .html 位址並丟棄 ?preview 部分,頁面接著會嘗試尚未上線的GIF。preview 參數只改變頁面顯示的內容;複製的簽名檔仍然指向 gifUrl。嘗試輸入長名稱以及 < 和 & 之類的字元,它們必須按輸入的內容顯示。
6. 部署
閱讀 references/deploy.md。它涵蓋了兩個檔案在常見技術棧(靜態主機、Next.js、Astro、WordPress、Webflow 等)中的放置位置、當使用者無法將檔案放到自己的網站時GIF的託管方式、robots.txt 行,以及上線後需要檢查的項目。遵循網站正常的發布變更方式:如果是git儲存庫,則使用分支和拉取請求。未經使用者同意,請勿推送或部署。
7. 移交
告訴使用者:
- 連結: 分享給團隊的頁面位址,以及GIF位址。
- 已驗證: 你自己檢查過的項目,例如渲染檢查、你檢視過的幀以及頁面預覽。
- 部署後仍需檢查: 從
deploy.md的清單中,貼到Gmail、Outlook和Apple Mail中測試。在GIF上線之前,無法檢查關於真實郵件應用程式的任何事項,因此請直接說明,而不是暗示它有效。 - 後續更新: 編輯
brand.json,重新渲染,並用相同的位址取代GIF。所有人的簽名檔會自動更新,但郵件應用程式的圖片快取可能需要一天或更長時間。