open-design-landing-deck
姊妹技能 open-design-landing。采用相同的 Atelier Zero 视觉系统(暖纸背景、Inter Tight + Playfair Display 字体、斜体强调、珊瑚色圆点),但以水平杂志风格滑动翻页的方式呈现,而非长滚动页面。
导航模式特意借鉴了 guizang-ppt 技能——←/→ 方向键、滚轮/滑动、ESC 键呼出概览网格——使其感觉像印刷杂志一页页翻动,而不是网页幻灯片滚动。
inputs.json + ../open-design-landing/styles.css
│
└──────────► scripts/compose.ts
│
▼
<out>/index.html
(每个幻灯片一个视口,水平滑动)
你将获得
- 一个自包含的 HTML 文件,包含 N 个视口大小的幻灯片,水平排列在一根经过变换的 flex 轨道上。
- 键盘导航:
←/→·↑/↓· PageUp/PageDown · Space · Home/End。 - 滚轮 + 触摸滑动(带有动量防护,防止单次触控板滑动过度)。
- 每张幻灯片的铬色条:品牌标记、幻灯片标题、位置、罗马数字年份、实时幻灯片计数器(
01 / 11)。 - 底部珊瑚色进度条,随翻页而填充。
- 底部附近的圆点指示器:点击任意圆点即可跳转。
- ESC 概览网格——所有幻灯片的缩放缩略图,点击即可跳转。镜像
guizang-ppt的概览用户体验。 - 重用姊妹技能的相同 16 槽图像库——无需重复资产。
幻灯片类型
| 类型 | 用途 |
|---|---|
cover | 开头的标题页。双栏文本 + 拼贴图案。 |
section | 章节之间的罗马数字分隔符。居中、全出血。 |
content | 眉题 + 标题 + 正文 + 项目符号 + 可选拼贴图案。 |
stats | 最多 4 个大型统计单元格(数值 · 标签 · 子标签)。 |
quote | 引用语 + 作者。右侧可选肖像拼贴。 |
cta | 结尾宣传 + 1-2 个按钮。 |
end | 特大斜体收尾词 + 签名页脚。 |
典型的 11 页演示:
1. cover — 标题页,英雄拼贴
2. section — "I. 问题"
3. content — 关于 / 宣言,要点
4. content — 能力,要点
5. stats — 4 个数字
6. section — "II. 感受如何"
7. content — 方法,要点
8. content — 精选作品
9. quote — 客户推荐
10. cta — 主要 + 次要操作
11. end — 特大收尾词 + 签名
工作流
1. 编写 inputs.json
从 inputs.example.json(开放设计演示文稿)开始。品牌块、图像策略和资产路径与姊妹技能一致——如果你已经填写过 open-design-landing 的简介,请将 brand 和 imagery 直接复制过来。
对于每张幻灯片,选择一个 kind 并根据 schema.ts 填写类型化字段。MixedText(无衬线基线 + 斜体强调跨度 + 珊瑚色终止点)与姊妹技能使用的编码相同——请参考其 inputs.example.json。
2. (可选)生成或桩图像
此技能不包含自己的图像生成器或占位符脚本——它共享 open-design-landing 的 16 槽库。要重新生成或创建桩:
# 通过 gpt-image-2 (fal.ai) 生成
FAL_KEY=... npx tsx ../open-design-landing/scripts/imagegen.ts ../open-design-landing/inputs.example.json --out=../open-design-landing/assets/
# 或纸质纹理 SVG 占位符
npx tsx ../open-design-landing/scripts/placeholder.ts ../open-design-landing/assets/
将你的演示文稿 inputs.imagery.assets_path 设置为这些 PNG 所在的路径(示例中的默认值为 ../open-design-landing/assets/)。
3. 撰写演示文稿
npx tsx scripts/compose.ts inputs.json out/index.html
编译器读取 inputs.json,从 ../open-design-landing/styles.css 加载规范的 Atelier Zero 样式表,在其上叠加演示文稿特定的规则(水平 flex 轨道、幻灯片布局、HUD、圆点导航、ESC 概览、键盘/滚轮/触摸处理程序),并写入一个自包含的 HTML 文件。
4. 自我检查
- 在新浏览器标签页中打开 HTML;第一张幻灯片(封面)显示,右上角铬色条显示
01 / N。 - 按
→(或 Space,或向下滚动)。平滑向右滑动一个视口;圆点导航前进;珊瑚色进度条前进一格。 - 按
End。跳转到最后一张幻灯片。 - 按
Home。返回第一张幻灯片。 - 按
Esc。出现带有缩放缩略图的概览网格;点击任意图块即可跳转并关闭概览。 - 将视口调整为 1080px 和 640px。封面/内容幻灯片折叠为单列;圆点导航仍有效;铬色条缩小。
-
prefers-reduced-motion: reduce(DevTools → 渲染):页面过渡依然灵敏,不会引起晕动症。 - Lighthouse:对比度 AA、font-display swap、无布局偏移。
边界
- 重用姊妹技能的样式表。 编译器在编译时读取
../open-design-landing/styles.css。不要在此处维护副本;如果 Atelier Zero 标记演变,请在姊妹技能中一次性编辑。 - 重用姊妹技能的图像库。 无需重新提示或重新渲染——相同的 16 张图板适用于两种形态。
- 保持幻灯片单视口。 如果幻灯片内容在 1280×800 下无法适应 100vh × 100vw,则会溢出并感到局促。请精简内容或拆分为两张幻灯片。
- 不要改用垂直滚动捕捉。 水平滑动姿态是让此技能感觉像杂志跨页的关键;垂直滚动条只会是一个长页面。
- 不要添加路由器。 这是单文件产物。多页演示文稿不在范围内;如需多演示文稿体验,请分别渲染每个演示文稿并从父索引链接。
另请参阅
open-design-landing— 落地页姊妹技能。guizang-ppt— 此技能借用的杂志式演示文稿导航模式。design-systems/atelier-zero/DESIGN.md— 标记规范。