编辑风格 PPTX 演示文稿
生成一份精致的、编辑风格简约的幻灯片,并导出为可编辑的 PPTX。最终交付物仅为 .pptx — HTML 幻灯片仅作为构建源,不生成 PDF 或 HTML 查看器。
工作原理
幻灯片以受限的 HTML 编写(每张幻灯片一个文件),然后 scripts/html2pptx.js 将每个 DOM 元素转换为原生 PowerPoint 对象(真实、可双击编辑的文本框)。页面固定为 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE)。
构建流程
复制此清单并跟踪进度:
- [ ] 1. 搭建项目结构 (shared/ assets/ slides/ output/)
- [ ] 2. 规划叙事 → 将每张幻灯片映射到一个模板类型
- [ ] 3. 根据模板编写 slides/NN-name.html(仅编辑文本)
- [ ] 4. 检查溢出 → 修复任何不完全是 1280x720 的幻灯片
- [ ] 5. 导出 PPTX(仅此文件)
- [ ] 6. 清理构建源(只保留 .pptx 文件)
1. 搭建项目结构。 在工作目录中创建 shared/、assets/、slides/、output/ 文件夹。将本技能中的 shared/tokens.css 复制到项目的 shared/ 文件夹中。仅将本技能 assets/ 中你将使用的图片复制到项目的 assets/ 文件夹中。安装一次依赖:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. 规划。 将源内容转换为幻灯片列表。每张幻灯片都属于一种模板类型。典型的演示文稿结构为:封面 →(分节页 → 1–3 张内容幻灯片)× 章节 → 结束页。保持文本简洁;此风格追求通透。
3. 编写幻灯片。 从 templates/ 复制最接近的模板到 slides/NN-name.html 并替换文本。规则:
- 保留
<link rel="stylesheet" href="../shared/tokens.css">。 - 标题使用衬线字体;其他所有文本使用无衬线字体(已通过 tokens 配置)。
- 仅使用一种红色强调色。谨慎使用深色面板(
--ink-panel),并仅搭配金色#C9A24B作为其强调色。 - 图片通过
<img>引入(绝不用 CSSbackground-image)。请参见图片库。
4. 验证是否适配。 超出边界的幻灯片在 PPTX 中会被裁剪:
node scripts/check_overflow.mjs --slides slides
修复所有标记为 OVERFLOW 的问题(缩短文本或调整位置),直到所有幻灯片都报告 1280x720。
5. 仅导出 PPTX。
node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx
幻灯片按文件名排序(01-…、02-…)。不要运行任何 PDF 或 HTML 导出——PPTX 是唯一交付物。
6. 清理。 删除 slides/ 中的 HTML 文件和所有临时文件,仅保留 output/DeckName.pptx(如果用户希望继续迭代,可保留可复用的 shared/ 和 assets/)。
设计系统
在 shared/tokens.css 中定义。不要发明新颜色。
| Token | HEX | 用途 |
|---|---|---|
--ink | #1A1A1A | 标题和主要正文 |
--soft | #555555 | 次要正文 |
--muted | #8C8C8C | 标签、注释、页码 |
--red | #C8102E | 唯一的强调色:条、引子、关键词、下划线 |
--red-deep | #A00C24 | 表格中的负向强调 |
--red-pale | #FBE9EC | 连接芯片(例如 “→” 圆圈) |
--box | #F4F3F1 | 浅色卡片 / 斑马纹行 |
--line | #E4E2DE | 细线分隔符 |
--ink-panel | #1C1C1C | 深色对比面板 |
| gold | #C9A24B | 仅用于深色面板的强调色 |
| background | #FFFFFF | 页面 |
- 字体:
h*/标题使用 Georgia 衬线字体;其他所有文字使用 Arial/Helvetica 无衬线字体。 - 标志性样式: 标题左侧的细红色竖线 + 上方带有小号字母间距的红色引子;底部居中放置小字号页码。
- 品牌调换: 要匹配其他公司,请更改
tokens.css中的--red(并可选择性地更改--ink-panel/gold)— 其他部分无需改动。
图片库
图片位于本技能的 assets/ 中。纵向图片填充右侧约 40% 的分节页/封面面板(object-fit:cover);横向图片适合全出血封面。
| 文件 | 方向 | 最佳用途 |
|---|---|---|
sail.png | 纵向 589×1024 | 分节页/封面右侧面板(默认) |
lighthouse-cliff.png | 纵向 627×1024 | 分节页/封面右侧面板 |
staircase.png | 高 312×1024 | 宁静/抽象的分节条幅 |
mast.png | 窄 208×1024 | 窄分节条幅 |
hiker-clouds.png | 窄 225×1024 | 窄分节条幅 |
lighthouse-sunset.png | 横向 1024×721 | 全出血封面 / 顶部条带 |
sailboat-deck.png | 横向 1024×721 | 全出血封面 / 顶部条带 |
通过更改 <img src="../assets/….png"> 来替换图片。在所有分节页中保持使用一张一致的图片(或一个主题)以保证整体协调性。用户也可以将自己的图片放入 assets/ 中。
模板目录
位于 templates/ 中(每个模板都是一个完整、无溢出、尺寸为 1280×720 的幻灯片):
| 文件 | 类型 |
|---|---|
01-cover.html | 分栏封面:左侧衬线标题,右侧纵向图片 |
02-divider.html | 分节页:引子 + 衬线标题 + 红色条,右侧纵向图片 |
03-three-column.html | 引子/标题 + 核心行 + 3 列 + 结果条带 |
04-mapping.html | 双列“他们想要什么 → 我们做什么”,带连接芯片 |
05-compare-table.html | 3 列对比表格,斑马纹行 |
06-dark-contrast.html | 双面板(浅色 vs 深色)+ 衬线页脚行 |
07-pipeline.html | 带编号的水平步骤管线 + 深色输出条 |
08-closing.html | 结束语:带编号的衬线行 + 右侧纵向图片 |
硬性限制
如果违反以下规则,HTML 到 PPTX 的转换将失败或渲染错误。完整细节及修复方法请参见 reference.md:
- 文本必须放在
<p>/<h1>–<h6>内(绝不允许在<div>中有游离文本)。 - 不能使用 CSS 渐变。
background/border/box-shadow只能用于<div>,绝对不能用于文本标签。- 不能使用
background-image;请使用<img>。 - 内联标签(
span/em/strong)不能含有外边距。 - 页面保持 1280×720;任何内容不得溢出。
