# PPTX 生成器 ## 何时使用此技能在以下情况下使用此技能： * 根据数据或规范以编程方式创建演示文稿 * 用动态内容填充品牌模板，同时保留企业风格 * 从现有 PPTX 文件中提取文本和结构进行分析 * 组合已批准模板库中的幻灯片 * 自动化演示文稿生成工作流程在以下情况下请勿使用此技能： * 用户想要打开/查看演示文稿（使用本机 PowerPoint 或查看器） * 需要复杂的动画或过渡（有限支持） * 使用较旧的 .ppt 格式（仅限 PPTX） ## 先决条件 * 安装 Deno () * 输入PPTX文件以进行基于模板的操作 * 用于暂存生成的 JSON 规范 ## 快速入门 ### 两种操作模式 1. **模板模式**：修改现有品牌模板 * 分析和替换：找到“{{PLACEHOLDERS}}”并替换为内容 * 幻灯片库：从模板库中选择并组合幻灯片 2. **Scratch 模式**：使用 JSON 规范从无到有创建演示文稿 ## 说明 ### 模式 1：基于模板的生成 #### 步骤 1a：分析模板提取文本清单以了解可以替换的内容： deno run --allow-read 脚本/analyze-template.ts Corporate-template.pptx > inventory.json **输出**（inventory.json）： { "filename": "企业模板.pptx", “幻灯片计数”：10， “文本元素”：[ { “幻灯片编号”：1， "shapeId": "形状-2", "shapeName": "标题 1", "placeholderType": "ctrTitle", “位置”：{“x”：1.5，“y”：2.0，“w”：7.0，“h”：1.2}， “段落”：[ { "text": "{{TITLE}}", "fontSize": 44, "bold": true } ] } ] } #### 步骤 1b：创建替换规范创建 `replacements.json`： { “文本替换”：[ { "tag": "{{TITLE}}", "value": "2024 年第四季度结果" }, { "tag": "{{SUBTITLE}}", "value": "财务概览" }, { "tag": "{{DATE}}", "value": "2024 年 12 月" }, { "tag": "{{AUTHOR}}", "value": "财务团队", "slideNumbers": [1] } ] } #### 步骤 1c：生成输出 deno run --allow-read --allow-write 脚本/generate-from-template.ts \ Corporate-template.pptx replacements.json 输出.pptx ### 模式 1（替代）：幻灯片库 #### 步骤 2a：预览模板幻灯片获取有关可用幻灯片的信息： deno run --allow-read script/generate-thumbnails.ts slip-library.pptx 对于视觉预览，提取缩略图： deno run --allow-read --allow-write 脚本/生成缩略图.ts \ 幻灯片库.pptx --extract-thumb --output-dir ./previews #### 步骤 2b：选择并组合幻灯片创建“selections.json”： { “幻灯片选择”：[ {“幻灯片编号”：1}， {“幻灯片编号”：5}， {“幻灯片编号”：12}， { “幻灯片编号”：3 } ], “文本替换”：[ { "tag": "{{TITLE}}", "value": "自定义演示文稿" } ] } #### 步骤 2c：生成组合演示文稿 deno run --allow-read --allow-write 脚本/generate-from-template.ts \ 幻灯片库.pptx 选择.json 定制甲板.pptx ### 模式 2：从头开始生成 #### 步骤 3a：创建规范创建“spec.json”： { "title": "2025 年产品发布", “作者”：“营销团队”， “幻灯片”：[ { “背景”：{“颜色”：“003366”}， “元素”：[ { “类型”：“文本”， “x”：1，“y”：2.5，“w”：8，“h”：1.5， “选项”：{ "text": "2025 年产品发布", “字体大小”：44， “大胆”：真实， “颜色”：“FFFFFF”， “对齐”：“居中” } }, { “类型”：“文本”， “x”：1，“y”：4，“w”：8，“h”：0.5， “选项”：{ "text": "革新行业", “字体大小”：24， “颜色”：“CCCCCC”， “对齐”：“居中” } } ] }, { “元素”：[ { “类型”：“文本”， “x”：0.5，“y”：0.5，“w”：9，“h”：0.7， “选项”：{ "text": "主要特点", “字体大小”：32， “大胆”：真实， “颜色”：“003366” } }, { “类型”：“表”， “x”：0.5，“y”：1.5，“w”：9，“h”：3， “选项”：{ “行”：[ [“功能”、“描述”、“优点”]、 [“速度”、“处理速度加快 2 倍”、“节省时间”]、 [“质量”、“高清输出”、“更好的结果”]、 [“集成”、“与现有工具配合使用”、“易于采用”] ], “边框”：{“pt”：1，“颜色”：“CCCCCC”} } } ] } ] } #### 步骤 3b：生成演示文稿 deno run --allow-read --allow-write 脚本/generate-scratch.ts spec.json 输出.pptx ## 示例 ### 示例1：公司季度报告 **场景**：从品牌模板生成季度报告。 **步骤**： # 1. 分析模板中的可替换内容 deno run --allow-read script/analyze-template.tsquarterly-template.pptx --pretty # 2. 使用第 4 季度数据创建 replacements.json # 3.生成报告 deno run --allow-read --allow-write 脚本/generate-from-template.ts \ 季度模板.pptx replacements.json Q4-2024-Report.pptx ### 示例 2：幻灯片库中的自定义宣传材料 **场景**：针对特定的客户推介组合批准的幻灯片。 **步骤**： # 1.查看可用的幻灯片 deno run --allow-read script/generate-thumbnails.tsitch-library.pptx # 2. 创建 Selections.json 选择幻灯片 1, 3, 7, 12, 15 # 3. 生成自定义牌组 deno run --allow-read --allow-write 脚本/generate-from-template.ts \ 音调库.pptx 选择.json acme-音调.pptx ### 示例 3：数据驱动的演示 **场景**：从 JSON 数据生成演示（例如 API 响应）。 **步骤**： # 1. 将数据转换为spec.json格式 # 2. 生成演示文稿 deno run --allow-read --allow-write 脚本/generate-scratch.ts data-spec.json report.pptx ## 脚本参考脚本 |目的|权限 ---|---|--- `分析模板.ts` |从 PPTX 中提取文本清单 | `--允许读取` `生成缩略图.ts` |获取幻灯片信息并提取预览 | `--允许读取 --允许写入` `从模板生成.ts` |修改模板（替换/组合）| `--允许读取 --允许写入` `生成-scratch.ts` |从 JSON 规范创建 PPTX | `--允许读取 --允许写入` ## 元素类型（草稿模式）类型 |描述 |关键选项 ---|---|--- `文本` |文本框| `文本`、`字体大小`、`粗体`、`颜色`、`对齐` `图像` |来自文件或 base64 的图像 | `路径`、`数据`、`大小` `表` |数据表| `行`、`colW`、`边框`、`填充` `形状` |几何形状| “类型”、“填充”、“线条”、“文本” `图表` |图表和图表 | `类型`、`数据`、`标题`、`showLegend` ## 常见问题及解决方案 ### 问题：文本未被替换 **症状**：输出 PPTX 仍然包含“{{PLACEHOLDER}}”标签。 **解决方案**： 1. 运行 `analyze-template.ts` 来验证准确的标签文本 2. 标签可以跨 XML 运行拆分 - 确保您的模板在单个文本运行中具有标签 3. 检查替换中的“slideNumbers”过滤器 ### 问题：幻灯片顺序不正确 **症状**：合并后幻灯片的顺序出现错误。 **解决方案**： * 幻灯片按照 `slideSelections` 中指定的顺序添加 * 验证幻灯片编号是否与原始模板匹配（1 索引） ### 问题：图像未出现 **症状**：输出中图像元素为空白。 **解决方案**： 1.使用绝对路径或相对于spec.json位置的路径 2. 验证镜像文件是否存在且可读 3.检查支持的格式：PNG、JPEG、GIF ## OOXML 占位符继承（高级）了解 PowerPoint 的 OOXML 格式如何处理占位符对于模板开发至关重要。 ### 继承链 PowerPoint 使用层次继承模型：主题 → 幻灯片母版 → 幻灯片布局 → 幻灯片 * **主题** ：定义颜色、字体、效果 * **幻灯片母版**：定义默认占位符位置和格式（包括项目符号） * **幻灯片布局**：覆盖特定布局类型的主设置（例如标题幻灯片、内容） * **幻灯片** ：包含实际内容，继承布局的格式 ### 关键原则 1. **文本内容不继承**：幻灯片必须包含自己的文本内容。布局中的“{{placeholder}}”文本不会自动显示在使用该布局的幻灯片上。 2. **文本格式可以继承** ：当幻灯片形状具有空的 `` 时，它会从布局的 `` 继承格式（颜色、大小、项目符号）。 3. **占位符链接**：通过 `` 幻灯片链接到布局。 `type`（例如“title”、“body”、“ctrTitle”）和“idx”必须匹配。 4. **项目符号抑制** ：要防止占位符上的项目符号通常从母版的 bodyStyle 继承，请在布局的 lstStyle 中添加 ``。 ### 定义可继承格式在布局占位符中，在“”（可继承）中定义颜色，而不是在“”（特定于运行）中定义颜色： {{placeholder}} ### 幻灯片形状结构要使幻灯片正确继承布局： {{placeholder}} ### 常见问题问题 |原因 |解决方案 ---|---|--- 文本显示为黑色而不是白色 |在``而不是``中定义的颜色 |将颜色移至布局的“”中的“” 不需要的子弹出现 | Master 的 bodyStyle 有项目符号，布局不会覆盖 |将 `` 添加到布局的 `` 占位符文本未出现 |文本仅在布局中，不在幻灯片中 |在幻灯片的“”中包含文本内容格式不适用|幻灯片具有明确的格式 |使用空 `` 和 `` ### 参考：占位符类型类型 |用途 ---|--- `ctrTitle` |居中标题（标题幻灯片） `标题` |标准标题 `副标题` |副标题 `身体` |内容区域（多个使用“idx”） `图片` |图片占位符 `dt` |日期/时间 `ftr` |页脚 `sldNum` |幻灯片编号 ## 限制 * **无幻灯片渲染** ：无法直接将幻灯片渲染为图像（为此使用 LibreOffice） * **有限的动画支持**：仅在草稿模式下提供基本动画 * **无母版幻灯片编辑**：模板模式保留但不修改母版 * **仅限 PPTX**：不支持旧版 .ppt 格式 * **文本运行拆分**：模板中的复杂格式可能会跨 XML 元素拆分标签 ## 相关技能 * **pdf-generator** ：用于创建 PDF 文档而不是演示文稿 * **docx-generator** ：用于创建Word文档 * **xlsx-generator** ：用于创建 Excel 电子表格

Pptx 生成器

包含技能