Installation
Die pptx-viewer-Pakete werden unabhangig voneinander auf npm veroffentlicht. Installieren Sie nur, was Sie benotigen: den frameworkunabhangigen Core-Engine oder eines der Framework-Viewer-Pakete.
Node-Version
Node.js 18 oder neuer ist fur die TypeScript-Kompilierung und fur die Ausfuhrung der Pakete ausserhalb des Browsers erforderlich.
Framework wahlen
| Framework | Paket | Hinweise |
|---|---|---|
| React | pptx-react-viewer | Vollstandig: Viewer, Editor, Prasentator, Export, Collaboration |
| Vue 3 | pptx-vue-viewer | Gleicher Engine und Funktionsumfang |
| Angular | pptx-angular-viewer | Gleicher Engine und Funktionsumfang |
| Headless (Node / Browser) | pptx-viewer-core | Keine UI, keine Framework-Abhangigkeit |
| KI / MCP-Werkzeuge | pptx-viewer-mcp | 25 MCP-Tools + CLI + Y.Doc-Codec |
Von npm installieren
React Viewer
Die vollstandige React-Viewer/Editor-Komponente, als pptx-react-viewer veroffentlicht. Der Core-Engine ist enthalten, Sie mussen ihn nicht separat installieren.
npm install pptx-react-viewer react react-dompnpm add pptx-react-viewer react react-domyarn add pptx-react-viewer react react-dombun add pptx-react-viewer react react-domWeitere Peer-Abhangigkeiten
Der Viewer benotigt auch framer-motion, lucide-react, react-icons, jspdf, jszip, fast-xml-parser und i18next/react-i18next - installieren Sie die, die Sie benotigen.
Vue 3 Viewer
Die Vue-3-Viewer-Komponente, als pptx-vue-viewer veroffentlicht. Der Core-Engine ist enthalten.
npm install pptx-vue-viewer vuepnpm add pptx-vue-viewer vueyarn add pptx-vue-viewer vuebun add pptx-vue-viewer vueAngular Viewer
Die Angular-Viewer-Komponente, als pptx-angular-viewer veroffentlicht. Der Core-Engine ist enthalten.
npm install pptx-angular-viewer @angular/core @angular/commonpnpm add pptx-angular-viewer @angular/core @angular/commonyarn add pptx-angular-viewer @angular/core @angular/commonbun add pptx-angular-viewer @angular/core @angular/commonCore-Engine
Der frameworkunabhangige Engine zum Analysieren, Bearbeiten, Serialisieren und Konvertieren von PPTX-Dateien.
npm install pptx-viewer-corepnpm add pptx-viewer-coreyarn add pptx-viewer-corebun add pptx-viewer-coreMCP-Server und Werkzeuge
25 PPTX-Manipulations-Tool-Funktionen, ein MCP-Server fur KI-Agenten und der Y.Doc-Zusammenarbeit-Codec.
npm install pptx-viewer-mcppnpm add pptx-viewer-mcpyarn add pptx-viewer-mcpbun add pptx-viewer-mcpOptionale Peer-Abhangigkeiten
Einige Funktionen im React-Paket werden nur aktiviert, wenn die optionalen Peers vorhanden sind.
| Funktion | Optionale Peers | Hinweise |
|---|---|---|
| 3D-Modelle (GLB/GLTF) | three | Ohne sie zeigen 3D-Elemente ihr Posterbild. |
| Echtzeit-Zusammenarbeit | yjs, y-websocket | Yjs CRDT mit Anwesenheitsverfolgung. |
Lokale Entwicklung (Monorepo klonen)
Das Monorepo verwendet Bun als Paketmanager. Pakete referenzieren sich gegenseitig uber das Protokoll workspace:*.
# Repository klonen
git clone https://github.com/ChristopherVR/pptx-viewer
cd pptx-viewer
# Alle Workspace-Abhangigkeiten installieren
bun install
# Alle Pakete bauen
bun run build
# Tests / Typprufung
bun run test
bun run typecheckBuild-Reihenfolge ist wichtig
Pakete mussen in der Abhangigkeitsreihenfolge gebaut werden:
core -> shared -> react / vue / angularbun run build vom Repo-Root ubernimmt dies fur Sie.
Haufige Workspace-Befehle
bun run build # Alle Pakete in Abhangigkeitsreihenfolge bauen
bun run test # vitest uber alle Pakete ausfuhren
bun run typecheck # Alle Pakete typprufen
bun run fmt # Mit oxfmt formatieren
bun run lint # Mit oxlint linten
bun run demo # React-Demo-Dev-Server starten (Port 4173)
bun run demo:vue # Vue-Demo-Dev-Server starten (Port 4175)
bun run demo:angular # Angular-Demo-Dev-Server starten (Port 4174)Nachste Schritte
- Schnellstart - Prasentation erstellen, analysieren, konvertieren und anzeigen.
- Architektur - wie die Schichten zusammenpassen.
- Einschrankungen - wichtige Hinweise vor dem Produktionseinsatz.