Skills › Visual Explainer › visual-explainer › README.md

README.md

32 lines · plugins/visual-explainer/pptx/README.md at 9d5f880

1# Best-effort PPTX export

3`visual-explainer-pptx` converts a generated visual-explainer HTML slide deck into a static `.pptx` file.

5The HTML deck remains the source of truth. This exporter is intentionally best-effort and supports simple decks with `<section class="slide">` elements. It extracts slide titles, short text, bullets, simple tables, code blocks, and Mermaid source placeholders.

7It does not preserve:

9- animations or transitions;

10- reader rail, outline, help, deep links, or resume state;

11- responsive layout;

12- custom web fonts;

13- live Mermaid rendering, Chart.js, SVG, canvas, or JavaScript behavior.

Best-effort PPTX export

visual-explainer-pptx converts a generated visual-explainer HTML slide deck into a static .pptx file.

The HTML deck remains the source of truth. This exporter is intentionally best-effort and supports simple decks with <section class="slide"> elements. It extracts slide titles, short text, bullets, simple tables, code blocks, and Mermaid source placeholders.

It does not preserve:

animations or transitions;
reader rail, outline, help, deep links, or resume state;
responsive layout;
custom web fonts;
live Mermaid rendering, Chart.js, SVG, canvas, or JavaScript behavior.

Raw lines 1 to 14

15## Usage

17From a package install:

19```bash

20visual-explainer-pptx ~/.agent/diagrams/my-deck.html ~/.agent/diagrams/my-deck.pptx

21```

23From a checkout, install dependencies first:

25```bash

26npm install --no-package-lock

27node plugins/visual-explainer/pptx/export.mjs ~/.agent/diagrams/my-deck.html ~/.agent/diagrams/my-deck.pptx

28```

30If you omit the output path, the exporter writes beside the input with a `.pptx` suffix.

32Use the HTML output for final fidelity. Use the `.pptx` as a portable static handoff when a presentation file is required.

Usage

From a package install:

visual-explainer-pptx ~/.agent/diagrams/my-deck.html ~/.agent/diagrams/my-deck.pptx

From a checkout, install dependencies first:

npm install --no-package-lock
node plugins/visual-explainer/pptx/export.mjs ~/.agent/diagrams/my-deck.html ~/.agent/diagrams/my-deck.pptx

If you omit the output path, the exporter writes beside the input with a .pptx suffix.

Use the HTML output for final fidelity. Use the .pptx as a portable static handoff when a presentation file is required.

Raw lines 15 to 32