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(svg_to_pptx): document --merge-paragraphs trade-off
hugohe3b2dcc364c05f
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 0d891189..253cc31f 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -444,6 +444,14 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>> SVG visual reference, so it's only needed when you want a self-contained file> to share. Pass `-s output` or `-s final` to force a single source if you need it.+> **Paragraph editability vs line fidelity** — by default every dy-stacked line is+> its own PowerPoint text frame, preserving exact SVG layout. Add `--merge-paragraphs`+> only when the user explicitly asks for an editable / wrap-friendly export (e.g.+> "I want to edit the abstract as one block", "make text boxes resizable / reflow"):+> mergeable paragraph blocks collapse into one editable text frame with multiple+> `<a:p>`, at the cost of PowerPoint re-wrapping inside each box. Default off keeps+> pixel-fidelity; turn it on per the user's request, not on your own judgement.+**Optional animation flags** (the defaults already enable rich entrance animations — adjust only when the user asks for something different):- `-t <effect>` — page transition. Default `fade`. Options: `fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`.- `-a <effect>` — per-element entrance animation. Default `mixed` (auto-vary across the deck). Pass `none` to disable, or pick a specific effect like `fade`. Requires top-level `<g id="...">` groups (already required by Executor).diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex 0b460518..c23c57cd 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -39,6 +39,7 @@ python3 scripts/svg_to_pptx.py <project_path> --no-notespython3 scripts/svg_to_pptx.py <project_path> -t nonepython3 scripts/svg_to_pptx.py <project_path> --auto-advance 3python3 scripts/svg_to_pptx.py <project_path> --animation mixed --animation-duration 0.8+python3 scripts/svg_to_pptx.py <project_path> --merge-paragraphs # editability-first mode (see below)python3 scripts/notes_to_audio.py <project_path> --voice zh-CN-XiaoxiaoNeuralpython3 scripts/svg_to_pptx.py <project_path> --recorded-narration audio```@@ -51,6 +52,11 @@ Behavior:- `exports/<project_name>_<timestamp>_svg.pptx` — SVG snapshot pptx for visual reference, sibling of the native pptx- Live preview already serves as the SVG visual reference for day-to-day use; the snapshot pptx is for distribution or frozen-state archival- Explicit `-o/--output` skips `backup/`; pair with `--svg-snapshot` to also emit the side-by-side `_svg.pptx` next to the chosen path+- `--merge-paragraphs` (opt-in) trades SVG line-layout fidelity for PowerPoint editability:+ - Default: every dy-stacked `<tspan>` becomes its own text frame — exact SVG line layout is preserved but a 12-line paragraph is 12 separate textboxes+ - With the flag: mergeable paragraph blocks (same x, dy clustered around one base line-height, optional larger gap for paragraph breaks) collapse into one editable text frame with multiple `<a:p>` and precise `<a:lnSpc>` / `<a:spcBef>`. Resizing the box reflows text inside it.+ - Side effect: PowerPoint may wrap merged paragraphs to a different line count than the SVG source. Pages with tight typographic alignment (covers, charts, tables) usually want the default; long body text (abstracts, multi-paragraph sections, reference lists) usually benefits from the flag+ - Mergeable detection is conservative: only fires when the children form a clean paragraph block; mixed-layout `<text>` falls through to the default per-line path- Recommended source directory: `svg_final/`- For PPTX template-import workspaces, use `-s svg-flat` when you need a visual round-trip check. The layered `svg/` tree is the machine-readable template source and intentionally does not inline inherited master / layout decoration into each slide.- Native mode is strict about unsupported visual SVG elements: if a visual element cannot be represented or safely preserved, export fails with the SVG file, element tag, and position instead of silently dropping content.