互動式電子賀卡 是做什麼的?
製作一張讓人愛不釋手的卡片:將對方的圖片放在立體卡的正面,卡片在頁面上輕柔搖曳,表面的箔紙或顏料隨著移動的光線閃耀;點擊即可打開,看到手寫風格的字跡;還能翻轉顯示背面。只需短短幾個步驟,就能將一張圖片和少許設定,製作成一份 HTML 檔案,裡面已包含所有內容(圖片、字型、渲染器),可以直接從檔案開啟,離線也能運作,並且不需修改就能放到任何網頁代管平台上。
本技能包含的內容:
scripts/make_card.py:根據卡片資料(JSON)建置頁面。它會在寫入任何檔案前先檢查資料並解釋任何錯誤。scripts/grid.py:在圖片上繪製帶有標籤的像素網格,其裁切方式與卡片完全一致,用來讀取位置資訊(僅在需要實體效果和顏色選取時使用)。scripts/foil_preview.py:以洋紅色顯示會變成箔紙的部分,讓您可以在建置前調整箔紙效果(需要 numpy)。scripts/snapshot.mjs(選擇性,需要 Node 和 Playwright):為正面、內頁和背面擷取螢幕截圖,搭配--live參數則可顯示實體卡片上會移動的部分以及每次點擊的效果。references/options.md:列出所有設定。references/living-cards.md解釋如何讓卡片活起來。在需要時再閱讀,不必事先全部讀完。
如何製作卡片
1. 取得圖片與訊息
您需要從對方那裡取得的兩項東西是:卡片正面的圖片,以及要寫在內頁的訊息。如果缺少任何一項,請向對方索取,或主動提議為對方代筆(詢問卡片要送給誰、以及誰送的)。其他所有設定都有合理的預設值,所以不必讓他們填寫問卷;請自行做良好選擇,並向對方說明您所做的選擇,以便他們可以更改。
按照對方給的原樣保留訊息。除非對方要求,否則不要修飾他們的文字,但請在一般手寫卡片會有換行的地方加入換行(例如問候語獨佔一行,結尾署名在最後);如果一行文字太長,紙張會在大約 20 個字母處自動換行。大約 60 字以內看起來字大且舒適;更長的訊息字體會變小,而當超出可容納範圍時,結尾會被截斷,因此建議請對方修剪過長的訊息。
多張圖片會在同一頁面上產生多張卡片,以類似縮圖列的方式切換。這適合製作一組卡片,或同一張卡片的不同設計以供挑選。
2. 觀察圖片並選擇表面處理
表面處理決定了卡片正面如何捕捉光線。在選擇前請先觀察圖片:
| 圖片類型 | 表面處理 | 備註 |
|---|---|---|
| 帶有筆刷紋理的繪畫(油畫、不透明水彩、壓克力、濃厚水彩) | paint | 顏料本身的筆觸會立體浮現並在光線下閃爍。如果含有金色顏料,也要讓它發亮:使用 foil.on: "colour" 並選取金色。 |
| 插畫、線稿、文字設計或扁平設計(特別是淺色紙張上) | foil | on: "details" 會將線條和深色細節壓印在箔紙上;"colour" 會將您選取的一種顏色(例如金色字樣)壓印在箔紙上;"darks" 則會將最暗的形狀(剪影)壓印在箔紙上。 |
| 照片 | print | 印在霧面卡片上。加上細箔紙 border 會很好看。在照片細節上使用箔紙容易顯得雜亂。 |
箔紙顏色:gold(經典、溫暖)、silver(冬季、婚禮、冷色調)、rose(浪漫)、copper(秋季、鄉村風格)、pink(活潑)、holo(全息效果,適合生日)。選擇能搭配圖片本身色調與場合的顏色。
在建置前(卡片資料寫好後,步驟 5)使用 foil_preview.py 檢查箔紙效果。您希望變成箔紙的部分應該呈現紮實的顏色,而且不應意外沾染到其他區域。有兩種情況常需要調整:
- 您想要箔紙的部分與不想要箔紙的部分共用相同的顏色或明暗度,例如金色字樣位於帶有金色花蕊的花朵上方。請使用
foil.area將箔紙限制在一個範圍內。 - 預設的金色是淺淡且經典的。如果藝術作品使用更深沈的金色,可以設定專屬的墨色,讓箔紙能夠匹配。
references/options.md 中的「箔紙」章節列出了各種墨色、每種模式下 amount 的作用以及 area。
紙張(內頁、背面和邊緣):white、cream、blush、sage、sky、midnight,或任何 #rrggbb 色碼。如果圖片本身就是畫在淺色紙上,卡片會預設使用那種紙張顏色,這通常看起來最好。
卡片會從圖片中央裁切出形狀:portrait(5:7,預設)、square、landscape(7:5)或 original(圖片的原始比例,但在範圍內)。對於寬幅圖片請使用 landscape。如果主體靠近邊緣,請執行 grid.py 查看裁切後保留了哪些部分。
3. 為場合添加效果(選擇性)
這些效果不需要指定位置,所以在適合卡片時可以自由添加:
snow:雪花在正面飄落(冬季、聖誕節)hearts:小愛心不時從圖片上浮起(愛情、情人節、母親節、婚禮)fireflies:柔和的光點在下方區域飄移(夏夜、夢幻場景)shootingStars:流星不時劃過頂端(夜空)sparkle:箔紙的亮點捕捉光線並閃爍(任何箔紙卡片)
一兩種效果就很足夠了,太多會顯得雜亂。
4. 讓卡片活起來(選擇性,而且是最棒的部分)
卡片可以做到更多:圖片中的燈籠會發光、搖曳並在點擊時閃爍;太陽會散發光芒;貓尾巴會甩動,撫摸時會有愛心升起;樹枝會搖擺並掉落雪花;圍巾會在滑鼠指標的微風中飄動。這需要在圖片上指定位置,您可以透過 grid.py 的網格來讀取這些位置。請閱讀 references/living-cards.md 並按照說明操作。
請在對方要求卡片要有生命感、動畫或互動性時,或者當圖片中有明顯的光源(蠟燭、燈籠、太陽、月亮、發光的窗戶)或角色時,才進行此步驟。這會花費一些時間,所以如果要快速製作卡片,可以將其作為下一步驟提供。
5. 編寫卡片資料
將資料儲存為 JSON 檔案,放在圖片旁邊。單張卡片範例:
{
"title": "艾莉,生日快樂",
"image": "ellie-birthday.jpg",
"alt": "一幅水彩畫,畫中有隻狐狸身處罌粟花草原。",
"name": "狐狸與罌粟花",
"finish": "foil",
"foil": { "colour": "rose", "on": "details", "amount": 0.12 },
"paper": "cream",
"message": "親愛的艾莉,\n祝我最在乎的人生日快樂。\n這將會是你最棒的一年!\n愛你的,諾拉",
"signature": ["滿滿的愛來自", "諾拉"],
"effects": { "hearts": true, "sparkle": true }
}
alt 用於為螢幕閱讀器描述正面圖片;請務必填寫。name 會以小字顯示在卡片背面,除非 back 或 signature 另有指定。多張卡片請使用 "cards": [ {...}, {...} ],並在頂層設定 title 和 page。所有設定都在 references/options.md 中。
6. 建置卡片
python scripts/make_card.py card.json --check # 檢查資料,並顯示卡片的像素尺寸
python scripts/make_card.py card.json -o card.html
JSON 中的路徑是相對於 JSON 檔案的位置。對於快速卡片,也提供一行指令的格式:
python scripts/make_card.py --image front.jpg --message "生日快樂!" --finish foil --foil gold -o card.html
如果腳本回報錯誤,它會說明問題所在以及如何修正。警告(例如缺少訊息、不認識的設定、位置超出卡片範圍)仍會建置,但請修正它們。
7. 檢查卡片
如果有 Node 和 Playwright,可以在交付前先檢視卡片:
node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live # 對於會動的卡片:同時檢查哪些部分會移動
這會將正面、光線停留在正面上的效果(front-lit:箔紙或顏料捕捉光線)、內頁和背面分別輸出為 PNG 圖片。檢查這些圖片:訊息是否容易閱讀?箔紙看起來是壓印上去的而不是斑點狀?圖片裁切的位置是否符合預期?調整後再重新建置;每次迭代都很快。如果沒有瀏覽器,請直接告知您無法預覽(箔紙預覽仍然可用)。
8. 交付卡片
將 HTML 檔案交給對方,並告訴他們如何使用:
- 在任何瀏覽器中開啟即可看到卡片。點擊它(或按 O 鍵)即可打開;拖曳它(或按 T 鍵)即可翻面。
- 要寄送卡片,請將其放在網路上並分享連結:GitHub Pages、Netlify Drop 或任何靜態代管平台都可以直接使用這個檔案。或者直接傳送檔案本身;它可以在離線狀態下運作。
- 檔案大小約為一到兩 MB,其中幾乎全部都是圖片。
用一句話向對方提及您所做的選擇(表面處理、箔紙、紙張、效果),以便他們可以要求修改。
實用資訊
- 手機拍攝的照片會自動旋轉為正確方向,大尺寸圖片會被縮小(使用 Pillow 函式庫)。透明區域會變成白色。HEIC 格式的照片需要先轉換為 JPEG,除非 Pillow 能夠讀取它們。
- 手寫風格字型為 Caveat,已內嵌在頁面中。它涵蓋拉丁文、擴展拉丁文以及西里爾字母;其他文字系統(越南文、希臘文、中日韓表意文字)則會使用裝置本身的字型作為替代。
- 如果不支援 WebGL,頁面仍會顯示圖片和訊息,但為平面效果。
- 頁面設計為淺色主題:卡片置於白色背景上,帶有柔和陰影。
- 如果想要在此技能提供的設定之外改變卡片的外觀或行為,渲染器的原始碼位於技能的 GitHub 儲存庫中(
renderer/),重新建置後會取代assets/greeting-card.js。