互动立体贺卡
做一张让人忍不住把玩的贺卡:他们的照片印在立体卡片封面,在页面上微微摆动,箔纸或颜料随着移动光线闪烁,轻触打开后呈现手写留言,翻转可见背面。一次简短构建即可将一张图和几项设置转化为一个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(彩虹色、生日)。匹配图片本身的色调和场合。
在构建前用 foil_preview.py 检查箔纸效果(一旦卡片数据写好,即步骤5)。你希望成为箔纸的区域应该是实心,且没有其他区域被意外选中。两种常见调整:
- 你想要箔纸的区域与不想要箔纸的区域共享相同颜色或亮度,例如金色文字位于带有金色花蕊的花卉之上。使用
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 或任何静态托管服务都可以原样接受该文件。或者直接发送文件本身;它离线也可以工作。
- 大小约为1-2兆字节,几乎全是图片。
用一句话提一下你选择的设置(表面、箔纸、纸张、特效),以便他们可以要求修改。
实用信息
- 手机照片会自动旋转正立,大图片会被缩小(使用Pillow)。透明区域变为白色。HEIC照片需要先转换为JPEG,除非Pillow可以读取。
- 手写字体为Caveat,已嵌入页面。它覆盖拉丁字母、扩展拉丁字母和西里尔字母;其他文字(越南语、希腊语、中日韩文字)会回退到设备自带的书法字体。
- 如果没有WebGL,页面仍会显示图片和留言,只是平面效果。
- 页面默认采用浅色主题:卡片带有柔和阴影,放置在白色背景上。
- 如果想要改变卡片的外观或行为,超出这些设置范围的功能,渲染器的源代码位于技能的GitHub仓库中(
renderer/),重新构建后可以替换assets/greeting-card.js。