Skip to content

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: update all references to reflect dual-output PPTX default

hugohe36b5632e0f54b
diff --git a/AGENTS.md b/AGENTS.md
index b746349b..b827967b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -42,7 +42,8 @@ python3 skills/ppt-master/scripts/total_md_split.py <project_path>
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
# ✅ Confirm no errors before running the next command
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
-# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
+# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)
+# Use --only native or --only legacy to generate just one version
```
## Core Directories
diff --git a/README.md b/README.md
index 21e0e723..467e3905 100644
--- a/README.md
+++ b/README.md
@@ -226,7 +226,9 @@ python3 skills/ppt-master/scripts/doc_to_md.py <DOCX_file>
python3 skills/ppt-master/scripts/total_md_split.py <project_path>
python3 skills/ppt-master/scripts/finalize_svg.py <project_path>
python3 skills/ppt-master/scripts/svg_to_pptx.py <project_path> -s final
-# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
+# Default: generates two files — native shapes (.pptx) + SVG reference (_svg.pptx)
+# Use --only native to skip SVG reference version
+# Use --only legacy to only generate SVG image version
```
> 📖 For complete tool documentation, see [Tools Usage Guide](./skills/ppt-master/scripts/README.md)
diff --git a/README_CN.md b/README_CN.md
index 49aa92d2..dee1a4a5 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -222,7 +222,8 @@ python3 skills/ppt-master/scripts/doc_to_md.py <DOCX文件>
python3 skills/ppt-master/scripts/total_md_split.py <项目路径>
python3 skills/ppt-master/scripts/finalize_svg.py <项目路径>
python3 skills/ppt-master/scripts/svg_to_pptx.py <项目路径> -s final
-# 备选:无 PowerPoint 时可加 --native 跳过手动"转换为形状",但稳定性不及 PPT 原生转换
+# 默认生成两个文件:原生可编辑形状 (.pptx) + SVG 图片参考版 (_svg.pptx)
+# 仅生成原生版:--only native 仅生成 SVG 图片版:--only legacy
```
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 48bbeb0b..20b2e665 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -176,5 +176,5 @@ python3 scripts/finalize_svg.py <project_path>
# 3. Export PPTX
python3 scripts/svg_to_pptx.py <project_path> -s final
-# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
+# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)
```
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index eaa28971..e5dee340 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -93,7 +93,7 @@ python3 scripts/finalize_svg.py <project_path>
# 3. Export PPTX (from svg_final/, embeds speaker notes by default)
python3 scripts/svg_to_pptx.py <project_path> -s final
-# Fallback: add --native if no PowerPoint available for manual "Convert to Shape"
+# Default: generates native shapes (.pptx) + SVG reference (_svg.pptx)
```
**Prohibited**:
diff --git a/skills/ppt-master/scripts/README.md b/skills/ppt-master/scripts/README.md
index c1394b7d..23329043 100644
--- a/skills/ppt-master/scripts/README.md
+++ b/skills/ppt-master/scripts/README.md
@@ -573,37 +573,38 @@ Batch converts SVG files in a project to a PowerPoint presentation, preserving v
**Features**:
-- Batch convert SVGs to PPTX
+- **Default: generates two files** — native shapes (.pptx) + SVG reference (_svg.pptx)
+- Native shapes version: directly editable DrawingML shapes in PowerPoint
+- SVG reference version: preserves SVG as image for archival and quality review
- Each SVG corresponds to one slide
- Auto-detect canvas format and set slide dimensions
- Support using svg_output or svg_final directories
-- SVGs remain editable in PowerPoint
- **Support slide transition and entrance animations**
- **Auto-embed speaker notes** (read from notes/ directory)
**Usage**:
```bash
-# Recommended: use the post-processed version (notes embedded by default)
+# Default: generates native shapes + SVG reference (two files)
python3 scripts/svg_to_pptx.py <project_path> -s final
-# Disable speaker notes
-python3 scripts/svg_to_pptx.py <project_path> -s final --no-notes
+# Only native shapes version (skip SVG reference)
+python3 scripts/svg_to_pptx.py <project_path> -s final --only native
-# Use original version
-python3 scripts/svg_to_pptx.py <project_path>
+# Only SVG image version
+python3 scripts/svg_to_pptx.py <project_path> -s final --only legacy
-# Specify output file
+# Specify output file (SVG ref → output_svg.pptx)
python3 scripts/svg_to_pptx.py <project_path> -s final -o output.pptx
+# Disable speaker notes
+python3 scripts/svg_to_pptx.py <project_path> -s final --no-notes
+
# Add slide transition effects
python3 scripts/svg_to_pptx.py <project_path> -t fade --transition-duration 1.0
# Silent mode
python3 scripts/svg_to_pptx.py <project_path> -s final -q
-
-# Native shapes (fallback when PowerPoint is unavailable for manual "Convert to Shape")
-python3 scripts/svg_to_pptx.py <project_path> -s final --native
```
**Speaker Notes**:
@@ -666,9 +667,11 @@ pip install python-pptx
**Notes**:
-- SVGs are embedded in native vector format, maintaining editability
+- Default generates two PPTX files: native shapes (editable) + SVG reference (archival)
+- Native shapes version is directly editable in PowerPoint without manual conversion
+- SVG reference version preserves original SVGs for quality review and version archival
+- Use `--only native` or `--only legacy` to generate just one version
- Requires PowerPoint 2016+ for correct display
-- File size is much smaller than the PNG approach
- Transition effects are off by default; users must explicitly enable them
- Speaker notes are on by default; use `--no-notes` to disable