Meadow 幻灯片
以Meadow风格构建的演示文稿,由一个小型JSON规格通过脚本生成,因此每张幻灯片都落在与Meadow自身销售文档相同的网格、字体比例和颜色上。您编写内容并选择布局;脚本负责像素工作,并在文字放不下时发出警告。
scripts/meadow_deck.py spec.json -> .pptx (+ --figma-json layout for Figma)
scripts/preview.py .pptx -> 每张幻灯片PNG + 联系表(使用LibreOffice或Keynote)
scripts/figma_render.js 通过 use_figma 绘制布局转储的一张幻灯片
scripts/install_fonts.sh 为当前用户安装 Geist / Geist Mono / Syne
references/layouts.md 每种布局、其字段及使用时机 <- 编写规格前先阅读
references/design-system.md 布局背后的标记和规则 <- 偏离布局时阅读
references/image-prompts.md 幻灯片图像的提示库 <- 幻灯片需要新图像时阅读
references/figma.md Figma输出配方及其注意事项 <- 仅当需要Figma时阅读
examples/sample-deck.json 一个涵盖主要布局的六页幻灯片(虚构数据)
examples/skill-intro-deck.json 介绍此技能的幻灯片(README图像)
工作流程
- 先获取内容。 询问(或从简报/旧文档/文档中提取)每张幻灯片的信息。如果用户交给您一个需要重新排版的原因文档,请逐字保留其文字:只修改他们要求修改的部分,并将删减或新标题作为单独的建议提供。人们会注意到自己的文字被悄悄改写。
- 大纲。 每张幻灯片一个想法。将每张幻灯片映射到
references/layouts.md中的一种布局(封面 → 内容幻灯片 → 联系人是通常的弧线)。当幻灯片超过约6页或简报不明确时,向用户展示大纲;否则直接构建。 - 检查数字。 商业演示文稿依赖预算、CPM/CPV、观看量。在排版前重新计算衍生数据(CPM = 预算 / 观看量 × 1000、总计、百分比)。如果数字对不上,仍然按用户给出的数据排版,并告知哪些数字不一致以及差异有多大。客户会做同样的算术。
- 编写规格(
deck.json),参见示例和references/layouts.md。图像是打包的短名称(wave-05、meadow-night-02、people-02-camera-blue)或路径。 - 构建:
python3 scripts/meadow_deck.py deck.json -o deck.pptx。 将每个WARN视为错误:缩短文本、拆分幻灯片或切换布局,然后重新构建。WARN行涉及文本溢出、西里尔字母使用 Syne 字体(无西里尔字形)、一张幻灯片上出现多个强调面板,以及每次构建都会运行的对齐门:- 文本在药丸、芯片、按钮或徽章中未光学居中(左右墨水填充和上下大写字母高度必须在1.5px内匹配);
- 内容超出96px侧边距(图像溢出幻灯片没问题);
- 边缘几乎对齐但相差1-4px:将它们对齐或明显分开;
- 一行或一列等大卡片中的间隙不均匀。
任何新的药丸形元素都应通过
Slide.pill()创建,该方法会调整大小并居中;内联跟随其他文本的文本(图标后跟数字、单位、徽章)使用flow=True构建,以便检查是否合适,但不需要对齐网格。
- 查看它。 最快且通用:向构建添加
--png preview/。它会用Pillow绘制相同布局,类似Keynote测量文本。要在Mac上检查PPTX是否正常加载字体,qlmanage -t -s 1600 -o preview/ deck.pptx会通过系统渲染幻灯片1(不打开应用)。python3 scripts/preview.py deck.pptx使用LibreOffice,或者最后才使用Keynote:Keynote脚本可能挂起并留下对话框,所以不要循环重试。打开contact-sheet.png和单张幻灯片。检查对齐、拥挤、照片上的对比度、空半张卡片以及页脚碰撞。Office渲染需要安装字体(scripts/install_fonts.sh)。 - 交付 .pptx 文件。提醒接收者需要字体(
assets/fonts,均免费,OFL许可证)或应使用--portable构建(见下文)。 - Figma(可选) 在要求时:遵循
references/figma.md。除非有人要求,否则不要写入他人的Figma文件。
使其看起来像Meadow的规则
这些是人们首先检查的规则。布局已经应用了它们,因此在编写文字或修改布局时它们主要重要。
- 深色画布,单块酸橙绿面板。 背景 #0E1013,卡片 #1A1D21,内行 #23262B。 酸橙绿 #D3FF31 标记幻灯片涉及的一个事物(报价、结果、关键标注)。一张幻灯片上两块酸橙绿面板会拉平层次结构。不要只是为了有一个强调色而将随机卡片涂成酸橙绿:一张幻灯片可以没有强调色。酸橙绿上的文字是近黑色,从不是白色。
- 字体。 拉丁文标题使用 Syne 字体,即使在俄语文档中也一样(封面上的产品名称如「Meadow Slides」)。包含任何西里尔字母的标题使用 Geist,因为 Syne 没有西里尔字母。脚本会根据每个标题(封面、章节、陈述、幻灯片和联系人标题)决定,因此用您希望设置的语言写入标题。正文始终是 Geist,标签使用 Geist Mono 大写,独立数字/KPI 使用 Syne(约36px起)。
- 网格。 96px 边距,顶部页眉(单色眉毛 + 64px 标题),内容在 y=264 和 y=944 之间,页脚 = 徽标 +
NN / NN。间距 24,卡片圆角 24,内边距 40。 - 用表面表达,而不是描边。 卡片通过填充而非轮廓区分。唯一的轮廓元素是类别芯片(1px 白色 18%)。
- 文字中不出现竞争对手名称。 仅当用户提供时才使用客户徽标/推荐。
- 排版: 脚本用非断行空格粘合短介词/连词和破折号,使行不以「в」、「и」、「—」结尾。在俄语文档中,数字写作
10 000+、$5 000、1,5 млн。 - 图表 为深色实心条形,酸橙绿背景或深色背景上的酸橙绿条形,零基线,高度与数据成比例。酸橙绿上的半透明黑色会变浑浊,因此不要使用。
图像
打包资源:6个抽象蓝色/酸橙绿波浪(wave-01…06)、3片夜空草地(meadow-night-01…03)、4张生活方式人物照片(people-…)和白色平台字形(instagram、tiktok、youtube、vk、telegram、x、linkedin、twitch)。波浪适合封面和章节分隔页,草地适合联系人和结题幻灯片,人物照片适合联系人和图文幻灯片。
当幻灯片需要新图像(例如内容工厂地板主题封面、案例场景)时,从 references/image-prompts.md 编写提示:风格前缀 + 场景 + 为所填充的插槽添加构图说明。如果图像生成工具已连接(例如 Magnific MCP images_generate),则提供生成;否则将提示传递过去,并通过路径将返回的文件接入规格。
输出变体
--portable:将每个字重映射为同一字体的常规/粗体。用于 Google Slides 导入或无法安装字体的接收者。层次结构保留,但细节丢失。--figma-json layout.json:导出计算的布局,供Figma渲染器使用。- 演讲者备注:为任何幻灯片添加 `