AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(faq): surface --merge-paragraphs as the answer to "paragraph split into many text boxes"
hugohe30c90f3c0f6ae
diff --git a/docs/faq.md b/docs/faq.mdindex 842a444b..d3ac126e 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -46,6 +46,22 @@ For better contemporary stock photography, set `PEXELS_API_KEY` and/or `PIXABAY_Yes. The main `.pptx` (native PowerPoint shapes — all text, graphics, and colors directly editable without any conversion) is saved to `exports/` with a timestamp. A copy of `svg_output/` (the Executor's raw SVG source) is always written to `backup/<timestamp>/svg_output/` so you can rebuild via `finalize_svg → svg_to_pptx` without re-running the LLM. Pass `--svg-snapshot` to additionally emit an SVG-image preview pptx alongside the native pptx in `exports/` — handy for cross-platform distribution as a single file; off by default because live preview already serves as the SVG visual reference for day-to-day work. Requires **Office 2016** or later.+## Q: Why is one paragraph split into multiple text boxes? Can I get one text box per paragraph instead?++By default yes — every visual line of body text becomes its own PowerPoint text frame. This preserves the SVG's exact line layout pixel-for-pixel, which matters for covers, charts, tables, and any page with tight typographic alignment.++If you'd rather edit body text as whole paragraphs, re-export with `--merge-paragraphs`:++```bash+python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> --merge-paragraphs+```++Mergeable paragraph blocks (same x, dy clustered around one line-height, optional larger gap for paragraph breaks) collapse into one editable text frame with multiple `<a:p>` and precise line-spacing. Resizing the box reflows text inside it.++**Trade-off**: PowerPoint may wrap the merged paragraphs to a different line count than the SVG source — so the page won't match the original layout exactly. Best for long-form body text (abstracts, multi-paragraph sections, reference lists); keep the default for layout-tight pages. The detection is conservative — mixed-layout `<text>` falls through to the default per-line path automatically.++When you're chatting with the AI, you can also just ask: "I want to edit the abstract as one block" / "make text boxes resizable" — the AI will turn this on for you. Defaults stay off so existing decks aren't affected.+## Q: What's the difference between the three Executors?- **Executor_General**: General scenarios, flexible layoutdiff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 48ff0c7e..97fd44a5 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -46,6 +46,22 @@ PPT Master 可以在任何能读取文件和执行命令的 AI 编程代理中可以。主 `.pptx`(原生 PowerPoint 形状,文字、图形、颜色均可直接编辑,无需转换)以时间戳命名保存至 `exports/`。Executor 的原始 SVG 源(`svg_output/` 副本)始终镜像到 `backup/<timestamp>/svg_output/`,便于归档或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 pptx,无需再走 LLM。加 `--svg-snapshot` 会额外在 `exports/` 内并排生成 SVG 快照版 pptx,便于跨平台单文件分发;默认关闭——日常开发/诊断场景中 live preview 已经提供了 SVG 视觉参考。需要 **Office 2016** 或更高版本。+## Q: 为什么一段正文被拆成了好几个文本框?能不能一段一个文本框?++默认就是按行拆框——SVG 里的每一视觉行都会变成一个独立的 PowerPoint 文本框。这样做是为了**逐像素保留 SVG 的版式**,对封面、图表、表格、以及任何对版式精度敏感的页面来说是必要的。++如果你希望按整段编辑正文,重新导出时加上 `--merge-paragraphs`:++```bash+python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> --merge-paragraphs+```++可合并的段落块(同 x、dy 围绕同一行距聚集、段间允许更大间距)会合并成一个可编辑的文本框,内部为多个 `<a:p>`,并精确保留行距。**拉伸框时文字会在框内自动重排**。++**代价**:PowerPoint 自动换行后,行数可能与原 SVG 不一致——页面版式会与原 SVG 有偏差。适合正文密集型页面(abstract、多段落章节、参考文献等);版式敏感的页面继续用默认。判定足够保守——非段落型 `<text>` 会自动落回默认的按行拆框路径。++跟 AI 对话时也可以直接说:"我想整段编辑 abstract" / "让文本框能自适应" —— AI 会替你打开这个开关。默认关闭,不影响已有项目。+## Q: 三种执行师有什么区别?- **Executor_General**: 通用场景,灵活布局