# PPTX 创建、编辑和分析 ## 概述根据要求创建、编辑或分析 .pptx 文件的内容。 .pptx 文件本质上是一个包含 XML 文件和其他资源的 ZIP 存档。不同的工具和工作流程可用于不同的任务。 ## 重要：首先阅读所有文档 **开始任何演示任务之前**，请完整阅读所有相关文档文件以了解完整的工作流程： 1. **创建新演示文稿**：阅读 [`html2pptx.md`]() 并[`css.md`]() 完整内容 2. **编辑现有演示文稿**：完整阅读 [`ooxml.md`]() 3. **对于基于模板的创建** ：阅读此文件的相关部分加上 [`css.md`]() **阅读这些文件时切勿设置任何范围限制。** 在开始之前了解完整的工作流程、约束和最佳实践对于制作高质量的演示文稿至关重要。部分知识会导致错误、样式不一致以及需要返工的视觉缺陷。 ## 阅读并分析内容 ### 文本提取要仅读取演示文稿的文本内容，请将文档转换为 Markdown： # 将文档转换为 Markdown python -m markitdown 文件路径.pptx ### 原始 XML 访问使用原始 XML 访问：评论、演讲者注释、幻灯片布局、动画、设计元素和复杂格式。要访问这些功能，请解压缩演示文稿并读取其原始 XML 内容。 #### 解压文件 `python ooxml/scripts/unpack.py ` **注意**：unpack.py 脚本位于相对于项目根目录的“skills/public/pptx/ooxml/scripts/unpack.py”。如果此路径中不存在该脚本，请使用“find”。 -name "unpack.py"` 来找到它。 #### 关键文件结构 * `ppt/presentation.xml` \- 主要演示文稿元数据和幻灯片引用 * `ppt/slides/slide{N}.xml` \- 各个幻灯片内容（slide1.xml、slide2.xml 等） * `ppt/notesSlides/notesSlide{N}.xml` \- 每张幻灯片的演讲者备注 * `ppt/comments/modernComment_*.xml` \- 特定幻灯片的评论 * `ppt/slideLayouts/` \- 幻灯片的布局模板 * `ppt/slideMasters/` \- 母版幻灯片模板 * `ppt/theme/` \- 主题和样式信息 * `ppt/media/` \- 图像和其他媒体文件 #### 版式和颜色提取 **要模拟示例设计**，请首先使用以下方法分析演示文稿的版式和颜色： 1. **读取主题文件** : 检查 `ppt/theme/theme1.xml` 的颜色 (``) 和字体 (``) 2. **幻灯片内容示例**：检查 `ppt/slides/slide1.xml` 的实际字体使用情况 (``) 和颜色 3. **搜索模式** ：使用 grep 在所有 XML 文件中查找颜色（``、``）和字体引用 ## 创建新的 PowerPoint 演示文稿 **无需模板** 从头开始创建新的 PowerPoint 演示文稿时，使用 **html2pptx** 工作流程将 HTML 幻灯片转换为具有精确定位的 PowerPoint。 ### 工作流程 1. **阅读文档** : 阅读 [`html2pptx.md`]() 并[`css.md`]() 完全（参见上面的“关键：首先阅读所有文档”部分） 2. **先决条件 - 提取 html2pptx 库**： * 提取脚本旁边的库：`mkdir -p html2pptx && tar -xzf Skills/public/pptx/html2pptx.tgz -C html2pptx` * 这将创建一个包含库文件和 CLI 二进制文件的 `html2pptx/` 目录 3. **计划演示**：按照 html2pptx.md“设计哲学”部分进行： * 美学方向和大胆的设计选择 * 调色板选择（请参阅“创建调色板”） * 版式策略 * 用幻灯片布局和演示者注释编写详细的大纲（每张幻灯片 1-3 句话） 4. **设置 CSS 变量** ：覆盖共享 `.css` 文件中的颜色、版式和间距的 CSS 变量（请参阅 css.md“设计系统变量”） 5. **创建 HTML 幻灯片**（16:9 为 960px × 540px）：按照 html2pptx.md 进行操作： * 幻灯片布局区域（标题、内容、脚注） * 关键文本规则（适当的 HTML 标签） * 支持的元素和样式 6. 使用 [`html2pptx`]() 库创建并运行 JavaScript 文件，将 HTML 幻灯片转换为 PowerPoint 并保存演示文稿 * 运行：`NODE_PATH="$(npm root -g)" 节点 your-script.js 2>&1` * 使用`html2pptx`函数处理每个HTML文件 * 使用 PptxGenJS API 将图表和表格添加到占位符区域 * 使用 `pptx.writeFile()` 保存演示文稿 * **⚠️ 关键：** 您的脚本必须遵循此示例结构。在编写脚本之前请仔细思考，以确保正确使用 API。不要调用 `pptx.addSlide`。 const pptxgen = require("pptxgenjs"); const { html2pptx } = require("./html2pptx"); // 创建一个新的 pptx 演示文稿 const pptx = new pptxgen(); pptx.layout = "LAYOUT_16x9"; // 必须匹配 HTML 正文尺寸 // 添加纯 HTML 幻灯片等待 html2pptx("slide1.html", pptx); // 添加带有图表占位符的 HTML 幻灯片 const {幻灯片：幻灯片2，占位符} =等待html2pptx（“幻灯片2.html”，pptx）; Slide.addChart(pptx.charts.LINE,chartData,占位符[0]); // 保存演示文稿等待 pptx.writeFile("输出.pptx"); 7. **视觉验证**：转换为图像并检查布局问题 * 首先将 PPTX 转换为 PDF：`soffice --headless --convert-to pdf output.pptx` * 然后将PDF转换为图像：`pdftoppm -jpeg -r 150 output.pdf slip` * 这会创建“slide-1.jpg”、“slide-2.jpg”等文件。 * 阅读每个生成的图像文件并仔细检查： * **文本截断** ：文本被标题栏、形状或幻灯片边缘截断 * **文本重叠**：文本与其他文本或形状重叠 * **定位问题**：内容太靠近幻灯片边界或其他元素 * **对比度问题**：文本和背景之间的对比度不足 * **对齐问题**：元素彼此未正确对齐 * **视觉层次**：正确强调重要内容 * **重要：所有幻灯片在交付给用户之前必须通过这些验证检查。** 不要跳过此步骤或交付有视觉缺陷的演示文稿。 * 如果发现问题，请按以下优先顺序修复它们： 1. **增加边距** \- 在有问题的元素周围添加更多填充/间距 2. **调整字体大小** \- 缩小文本大小以适合可用空间 3. **完全重新考虑布局** \- 如果上述修复不起作用，请重新设计幻灯片布局 * 更改后重新生成演示文稿 * 重复直到所有幻灯片视觉正确 ## 编辑现有的 PowerPoint 演示文稿要编辑现有 PowerPoint 演示文稿中的幻灯片，请使用原始 Office Open XML (OOXML) 格式。这涉及解压 .pptx 文件、编辑 XML 内容以及重新打包。 ### 工作流程 1. **阅读文档** ：完整阅读 [`ooxml.md`]() （请参阅上面的“关键：首先阅读所有文档”部分） 2. 解压演示文稿：`python ooxml/scripts/unpack.py ` 3. 编辑XML文件（主要是`ppt/slides/slide{N}.xml`及相关文件） 4. **关键**：每次编辑后立即验证：`python ooxml/scripts/validate.py --original ` 5. 打包最终演示文稿：`python ooxml/scripts/pack.py ` ## 使用模板创建新的 PowerPoint 演示文稿** 要创建遵循现有模板设计的演示文稿，请在替换占位符内容之前复制并重新排列模板幻灯片。 ### 工作流程 1. **提取模板文本并创建可视化缩略图网格**： * 提取文本：`python -m markitdown template.pptx > template-content.md` * 完整阅读 `template-content.md` 以了解模板内容 * 创建缩略图网格：`python script/thumbnail.py template.pptx` * 有关更多详细信息，请参阅创建缩略图网格部分 2. **分析模板并将库存保存到文件**： * **视觉分析**：查看缩略图网格以了解幻灯片布局、设计模式和视觉结构 * 在“template-inventory.md”中创建并保存模板清单文件，其中包含： # 模板库存分析 **幻灯片总数：[计数]** **重要提示：幻灯片的索引为 0（第一张幻灯片 = 0，最后一张幻灯片 = count-1）** ## [类别名称] - 幻灯片 0：[布局代码（如果有）] - 描述/用途 - 幻灯片 1：[布局代码] - 描述/用途 - 幻灯片 2：[布局代码] - 描述/用途 [...每张幻灯片都必须单独列出其索引...] * **使用缩略图网格** ：参考视觉缩略图来识别： * 布局模式（标题幻灯片、内容布局、部分分隔线） * 图像占位符位置和计数 * 幻灯片组之间的设计一致性 * 视觉层次和结构 * 需要此清单文件才能在下一步中选择适当的模板 3. **根据模板清单创建演示大纲**： * 查看第 2 步中的可用模板。 * 为第一张幻灯片选择简介或标题模板。这应该是第一个模板。 * 为其他幻灯片选择安全的、基于文本的布局。 * **关键：将布局结构与实际内容相匹配**： * 单栏布局：用于统一叙述或单一主题 * 两列布局：仅当恰好有 2 个不同的项目/概念时使用 * 三列布局：仅当恰好有 3 个不同的项目/概念时使用 * 图像 + 文本布局：仅在需要插入实际图像时使用 * 引用布局：仅用于人们的实际引用（带有归属），切勿用于强调 * 切勿使用占位符多于可用内容的布局 * 对于 2 个项目，避免强制它们采用 3 列布局 * 对于 4 个以上的项目，请考虑分成多张幻灯片或使用列表格式 * 在选择布局之前计算实际内容片段 * 验证所选布局中的每个占位符都将填充有意义的内容 * 选择一个代表每个内容部分的**最佳**布局的选项。 * 使用内容和利用可用设计的模板映射保存“outline.md” * 模板映射示例： # 要使用的模板幻灯片（基于 0 的索引） # 警告：验证索引是否在范围内！包含 73 张幻灯片的模板索引为 0-72 # 映射：大纲中的幻灯片编号 -> 模板幻灯片索引模板映射 = [ 0, # 使用幻灯片 0（标题/封面） 34, # 使用幻灯片 34（B1：标题和正文） 34, # 再次使用幻灯片 34（第二个 B1 重复） 50, # 使用幻灯片 50（E1：引用） 54, # 使用幻灯片 54（F2：结束 + 文本） ] 4. **使用`rearrange.py`复制、重新排序和删除幻灯片**： * 使用 `scripts/rearrange.py` 脚本创建一个新的演示文稿，其中幻灯片按所需顺序排列： python脚本/rearrange.py模板.pptx工作.pptx 0,34,34,50,52 * 该脚本可以处理重复幻灯片的复制、删除未使用的幻灯片以及自动重新排序 * 幻灯片索引从 0 开始（第一张幻灯片是 0，第二张幻灯片是 1，等等） * 相同的幻灯片索引可以出现多次以复制该幻灯片 5. **使用`inventory.py`脚本提取所有文本**： * **运行库存提取**： python 脚本/inventory.pyworking.pptx text-inventory.json * **完整阅读 text-inventory.json** 以了解所有形状及其属性 * 库存JSON结构： { “幻灯片-0”：{ “形状-0”：{ "placeholder_type": "TITLE", // 对于非占位符则为 null "left": 1.5, // 位置（以英寸为单位） “顶部”：2.0， “宽度”：7.5， “高度”：1.2， “段落”：[ { "text": "段落文本", // 可选属性（仅在非默认时包含）： "bullet": true, // 检测到明确的项目符号 "level": 0, // 仅当项目符号为 true 时才包含 "alignment": "CENTER", // 居中，向右（不是向左） "space_before": 10.0, // 段落之前的空格（以磅为单位） "space_after": 6.0, // 段落后的空间（以磅为单位） "line_spacing": 22.4, // 行间距（以磅为单位） "font_name": "Arial", // 从第一次运行开始 "font_size": 14.0, // 以磅为单位 “大胆”：真实， “斜体”：假， “下划线”：假， "color": "FF0000" // RGB 颜色 } ] } } } * 主要特点： * **幻灯片** ：命名为“slide-0”、“slide-1”等。 * **形状** ：按视觉位置（从上到下、从左到右）排序，如“shape-0”、“shape-1”等。 * **占位符类型**：TITLE、CENTER_TITLE、SUBTITLE、BODY、OBJECT 或 null * **默认字体大小** ：从布局占位符中提取的“default_font_size”（以点为单位）（如果可用） * **幻灯片编号已过滤** ：具有 SLIDE_NUMBER 占位符类型的形状会自动从库存中排除 * **Bullets** : 当`bullet: true`时，总是包含`level`（即使是0） * **间距** ：`space_before`、`space_after` 和 `line_spacing` 以点为单位（仅在设置时包含） * **颜色** ：`color` 表示 RGB（例如，“FF0000”），`theme_color` 表示主题颜色（例如，“DARK_1”） * **属性** ：输出中仅包含非默认值 6. **生成替换文本并将数据保存到 JSON 文件** 基于上一步的文本清单： * **关键**：首先验证库存中存在哪些形状 - 仅参考实际存在的形状 * **VALIDATION** ：replace.py 脚本验证替换 JSON 中的所有形状是否存在于库存中 * 引用不存在的形状会产生显示可用形状的错误 * 引用不存在的幻灯片会产生错误，指示该幻灯片不存在 * 在脚本退出之前立即显示所有验证错误 * **重要**：replace.py 脚本在内部使用 inventory.py 来识别所有文本形状 * **自动清除** ：库存中的所有文本形状都会被清除，除非为其提供“段落” * 将“paragraphs”字段添加到需要内容的形状（而不是“replacement_paragraphs”） * 替换 JSON 中没有“段落”的形状会自动清除其文本 * 带项目符号的段落自动左对齐。当 `"bullet": true` 时避免设置 `alignment` 属性 * 为占位符文本生成适当的替换内容 * 使用形状大小来确定合适的内容长度 * **关键** ：包括原始库存中的段落属性 - 不要只提供文本 * **重要**：当项目符号：true 时，请勿在文本中包含项目符号（•、-、*） - 它们会自动添加 * **基本格式规则**： * 标题/标题通常应该有 `"bold": true` * 列表项应该有 `"bullet": true, "level": 0` (当项目符号为 true 时需要级别) * 保留任何对齐属性（例如，“对齐”：“CENTER”用于居中文本） * 包含与默认值不同的字体属性（例如，`"font_size": 14.0`、`"font_name": "Lora"`） * 颜色：使用 `"color": "FF0000"` 表示 RGB 或使用 `"theme_color": "DARK_1"` 表示主题颜色 * 替换脚本需要**格式正确的段落**，而不仅仅是文本字符串 * **重叠形状** ：首选具有较大 default_font_size 或更合适的 placeholder_type 的形状 * 将更新后的库存和替换品保存到“replacement-text.json” * **警告**：不同的模板布局具有不同的形状数量 - 在创建替换件之前始终检查实际库存显示正确格式的示例段落字段： “段落”：[ { "text": "新的演示文稿标题文本", “对齐”：“中心”， “粗体”：真实 }, { "text": "节标题", “粗体”：真实 }, { "text": "第一个没有项目符号的项目符号点", “子弹”：真实， “等级”：0 }, { "text": "红色文本", “颜色”：“FF0000” }, { "text": "主题彩色文本", “主题颜色”：“DARK_1” }, { "text": "没有特殊格式的常规段落文本" } ] **替换 JSON 中未列出的形状将自动清除**： { “幻灯片-0”：{ “形状-0”：{ "paragraphs": [...] // 该形状获取新文本 } // 库存中的 shape-1 和 shape-2 将自动清除 } } **演示文稿的常见格式模式**： * 标题幻灯片：粗体文本，有时居中 * 幻灯片中的节标题：粗体文本 * 项目符号列表：每个项目需要 `"bullet": true, "level": 0` * 正文：通常不需要特殊属性 * 引号：可能有特殊的对齐或字体属性 7. **使用`replace.py`脚本应用替换** python 脚本/replace.pyworking.pptx replacement-text.jsonoutput.pptx 该脚本将： * 首先使用 inventory.py 中的函数提取所有文本形状的清单 * 验证替换 JSON 中的所有形状都存在于库存中 * 库存中识别的所有形状的清晰文本 * 仅将新文本应用于替换 JSON 中定义的“段落”形状 * 通过应用 JSON 中的段落属性来保留格式 * 自动处理项目符号、对齐方式、字体属性和颜色 * 保存更新的演示文稿验证错误示例：错误：替换 JSON 中的形状无效： - 在“slide-0”上找不到形状“shape-99”。可用形状：形状 0、形状 1、形状 4 - 在库存中找不到幻灯片“slide-999” 错误：替换文本使这些形状中的溢出变得更糟： - Slide-0/shape-2：溢出恶化了 1.25 英寸（之前为 0.00 英寸，现在为 1.25 英寸） ## 创建缩略图网格要创建 PowerPoint 幻灯片的可视化缩略图网格以供快速分析和参考： python 脚本/thumbnail.py template.pptx [输出前缀] **特点**： * 创建：“thumbnails.jpg”（或“thumbnails-1.jpg”、“thumbnails-2.jpg”等，适用于大型套牌） * 默认：5 列，每个网格最多 30 张幻灯片 (5×6) * 自定义前缀：`python script/thumbnail.py template.pptx my-grid` * 注意：如果您希望在特定目录中输出（例如“workspace/my-grid”），则输出前缀应包含路径 *调整列：`--cols 4`（范围：3-6，影响每个网格的幻灯片） * 网格限制：3 列 = 12 张幻灯片/网格、4 列 = 20、5 列 = 30、6 列 = 42 * 幻灯片是零索引的（幻灯片 0、幻灯片 1 等） **用例**： * 模板分析：快速了解幻灯片布局和设计模式 * 内容回顾：整个演示文稿的视觉概述 * 导航参考：通过视觉外观查找特定幻灯片 * 质量检查：验证所有幻灯片的格式是否正确 **示例**： # 基本用法 python 脚本/thumbnail.py 演示文稿.pptx # 组合选项：自定义名称、列 python 脚本/thumbnail.py template.pptx 分析 --cols 4 ## 将幻灯片转换为图像要直观地分析 PowerPoint 幻灯片，请使用两步过程将其转换为图像： 1. **将 PPTX 转换为 PDF** : soffice --headless --convert-to pdf template.pptx 2. **将 PDF 页面转换为 JPEG 图像** : pdftoppm -jpeg -r 150 模板.pdf 幻灯片这将创建“slide-1.jpg”、“slide-2.jpg”等文件。选项： * `-r 150`：将分辨率设置为 150 DPI（调整质量/尺寸平衡） * `-jpeg`：输出 JPEG 格式（如果愿意，请使用 `-png` 作为 PNG） * `-f N`：要转换的第一页（例如，`-f 2` 从第 2 页开始） * `-l N`：要转换的最后一页（例如，`-l 5` 在第 5 页停止） * `slide`: 输出文件的前缀具体范围示例： pdftoppm -jpeg -r 150 -f 2 -l 5 template.pdf slip # 仅转换第 2-5 页 ## 代码风格指南 **重要**：生成 PPTX 操作的代码时： * 编写简洁的代码 * 避免冗长的变量名和多余的操作 * 避免不必要的打印语句 ## 依赖关系所需的依赖项（应该已安装）： * **markitdown** : `pip install "markitdown[pptx]"` （用于从演示文稿中提取文本） * **pptxgenjs** : `npm install -g pptxgenjs` （用于通过 html2pptx 创建演示文稿） * **playwright** : `npm install -g playwright` （用于 html2pptx 中的 HTML 渲染） * **react-icons** : `npm install -g React-icons React React-dom` （适用于 SVG 格式的图标） * **LibreOffice** ：用于 PDF 转换（视觉验证步骤所需） * macOS：`brew install --cask libreoffice` * Linux：`sudo apt-get install libreoffice` * **Poppler** ： `sudo apt-get install poppler-utils` （用于 pdftoppm 将 PDF 转换为图像） * **defusedxml** : `pip install defusedxml` （用于安全 XML 解析）

PPTX

包含技能