启动视频品牌套件
每个启动视频的外观都从 brand/brand.json 文件中读取。本技能可从 Reader 的网站生成该文件,进行检查,并交付给 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需要浅色版本:向 Reader 索取其文件,或修改
logo-on-dark.svg中的颜色。 - 强调色。它应该是人们将该品牌关联起来的颜色,通常是主要按钮的颜色。
evidence.json列出了带有投票数的accent_candidates。如果工具选择了英雄插图颜色或状态颜色,则替换为正确的十六进制值。 - 底色和文字色。叙事场景使用
ground作为底色,ink作为文字色。它们必须与网站的感觉相匹配(暖色米白、纯白、有色纸张)。 - 深色。英雄卡片使用
dark。它应该看起来像品牌自己的深色板块,而不是随机的接近黑色。如果网站没有深色板块,工具会加深强调色;检查其效果是否与预期一致。 - 字体。显示字体必须在预览表的英雄文本中正确渲染。
evidence.json中的fonts部分显示找到了哪些文件。 - 名称和标语。标语位于锁定画面中的名称下方:2 到 8 个单词,使用网站自身的表述。
直接在 brand.json 中修正错误值,重新渲染预览,向 Reader 展示,然后才将 "reviewed": true 设置为真。在回复中用一行记录您手动更改的任何内容。
每个角色在视频中的作用
| 角色 | 用途 |
|---|---|
ground | 每个叙事场景、产品展示的地面、结尾锁定画面。 |
surface | 在底色上的卡片、标签和窗口。 |
ink, ink_secondary | 浅色背景上的英雄文字和辅助文字。 |
accent | 谨慎使用:每个场景使用 1 个元素(按钮按下、切换、完成状态)。除非简报要求英雄卡片使用强调色,否则不作为整个底色。 |
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。工具会回退到网站图标并告知。向 Reader 索取 SVG(最佳)或宽度至少 1000 px 的透明 PNG;将其放入
brand/并将logo.file指向它。 - 深色模式网站。
mode为dark。页面背景变为dark,而ground和ink从深色模式推导出用于浅色叙事场景。如果品牌也想要深色叙事场景,手动交换ground和dark(以及ink和dark_ink)。 - 单色品牌。没有饱和颜色获得投票,因此
accent是主要按钮颜色(通常是黑色),而highlight是浅灰色。询问 Reader 是否有品牌标志性颜色;如果没有,保持单色,让字体和动画承载视频。 - 网络字体无法下载。某些字体厂商阻止直接下载。在本地安装字体(视频按家族名称回退到已安装字体)或从 Google Fonts 选择最接近的开放字体,并将其文件放入
brand/fonts/。 - 字体许可。网络许可证通常不涵盖视频。在视频发布前,确认显示字体和正文字体已获得视频或动态使用许可,或使用开放(OFL)字体。
- Reader 有品牌指南。以他们的指南为准。手动将其值输入
brand.json(保持相同键),将Logo文件放入brand/,重新渲染预览并标记为已复查。 - 网站阻止无头浏览器。从普通浏览器保存页面(文件,另存为,完整)并在此保存的 HTML 文件上运行工具。
交付
launch-film 在构建时读取 brand/brand.json。当 "reviewed": false 时构建的视频是草稿;展示时请标明。