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: sync animation-trigger naming across remaining doc surfaces

hugohe3d7250afa03ce
diff --git a/docs/faq.md b/docs/faq.md
index f680cc50..8d20e0c0 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -61,8 +61,9 @@ Yes. Page transitions (`fade` 0.4s by default) and per-element entrance animatio
```bash
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # different transition
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # disable transitions
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # enable per-element
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # enable per-element (on-click)
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed # auto-vary effects
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous # cascade without clicks
```
Full effect list, anchor logic (top-level `<g id="...">`), fallback behavior, and limitations: see [Animations & Transitions](./animations.md).
diff --git a/docs/zh/faq.md b/docs/zh/faq.md
index 2d393f1f..1c4ef7de 100644
--- a/docs/zh/faq.md
+++ b/docs/zh/faq.md
@@ -61,8 +61,9 @@ PPT Master 本身免费开源,唯一的成本来自你自己的 AI 模型用
```bash
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # 换转场效果
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # 关闭转场
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 开启页内动画
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 开启页内动画(单击触发)
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed # 自动混搭效果
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous # 自动级联(不需要点击)
```
完整效果列表、`<g id="...">` 锚点机制、降级行为、限制:见 [转场与动画](./animations.md)。
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index da1d484c..997a0d42 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -245,13 +245,13 @@ Color: use the deck's primary brand color for emphasis. Reserve green/red for ac
### Element Grouping (Mandatory)
-Wrap logically related elements in top-level `<g id="...">` groups. Produces PowerPoint groups in PPTX, making slides easier to select/move/edit and providing stable anchors for optional click-by-click entrance animation.
+Wrap logically related elements in top-level `<g id="...">` groups. Produces PowerPoint groups in PPTX, making slides easier to select/move/edit and providing stable anchors for optional per-element entrance animation.
> ⚠️ Only `<g opacity="...">` is banned (§2). Plain `<g>` for grouping is required.
-**Animation-ready rule**: direct children of `<svg>` should be semantic groups, not raw drawing atoms. Aim for **3–8 top-level content `<g id>` groups per slide** (the 3–8 budget excludes page chrome — see below); each content group should correspond to one presenter click if page-level animation is enabled.
+**Animation-ready rule**: direct children of `<svg>` should be semantic groups, not raw drawing atoms. Aim for **3–8 top-level content `<g id>` groups per slide** (the 3–8 budget excludes page chrome — see below); each content group becomes one entrance step under the chosen `--animation-trigger` mode (one click in `on-click`, one cascade slot in `after-previous`, parallel in `with-previous`).
-**Chrome groups are excluded automatically.** The exporter treats top-level groups whose id contains chrome tokens as page chrome and skips them in the animation cascade — they appear together with the slide rather than requiring a click. Tokens (matched against id after splitting on `-` / `_`): `background`, `bg`, `decoration` / `decorations` / `decor`, `header`, `footer`, `chrome`, `watermark`, `pagenumber` / `pagenum` / `page-number`. So `<g id="bg-texture">`, `<g id="cover-footer">`, `<g id="p03-header">`, `<g id="bottom-decor">` all skip animation while keeping their `<g>` wrapper for editing/grouping. Use these naming conventions for chrome — do **not** strip the `<g>` wrapper.
+**Chrome groups are excluded automatically.** The exporter treats top-level groups whose id contains chrome tokens as page chrome and skips them in the animation sequence — they appear together with the slide. Tokens (matched against id after splitting on `-` / `_`): `background`, `bg`, `decoration` / `decorations` / `decor`, `header`, `footer`, `chrome`, `watermark`, `pagenumber` / `pagenum` / `page-number`. So `<g id="bg-texture">`, `<g id="cover-footer">`, `<g id="p03-header">`, `<g id="bottom-decor">` all skip animation while keeping their `<g>` wrapper for editing/grouping. Use these naming conventions for chrome — do **not** strip the `<g>` wrapper.
**What to group**:
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index da9fcecc..03ad38a7 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -47,10 +47,11 @@ Behavior:
- Recommended source directory: `svg_final/`
- Speaker notes are embedded automatically unless `--no-notes` is used
- Page transitions are controlled by `-t/--transition`; per-element entrance animations are controlled by `-a/--animation`
-- Per-element animation applies to top-level SVG `<g id="...">` groups in z-order, with one presenter click revealing one semantic group; aim for 3–8 groups per slide
+- Per-element animation applies to top-level SVG `<g id="...">` groups in z-order; aim for 3–8 content groups per slide. Page chrome (background / header / footer / decorations / watermark / page number, by id token) is skipped automatically
+- Start mode is set by `--animation-trigger`, mirroring PowerPoint's Start dropdown: `on-click` (default, presenter-paced), `with-previous` (all together on slide entry), `after-previous` (cascade with `--animation-stagger` spacing)
- Flat SVG roots without top-level groups fall back to at most 8 visible primitives; beyond that, animation is skipped on the slide
- `mixed` is deterministic: the first animated group on each slide uses `fade`, then later groups cycle through a curated visible-effect pool across the whole deck; `random` samples from that same pool
-- `--animation-stagger` is retained for old commands but ignored by click-by-click timing; use `--animation-duration` for reveal pacing
+- `--animation-duration` controls per-element entrance length; `--animation-stagger` adds gap between elements in `after-previous` mode
Dependency: