Erstellung, Bearbeitung und Analyse von PPTX-Dateien
Eine .pptx-Datei ist ein ZIP-Archiv mit XML-Dateien. Wählen Sie Ihren Ansatz je nach Aufgabe:
| Aufgabe | Ansatz |
|---|---|
| Erstellen einer neuen Präsentation | Schreiben Sie ein pptxgenjs-Skript – beachten Sie die Fallstricke unten |
| Bearbeiten einer vorhandenen Präsentation oder Erstellen aus einer Vorlage | Entpacken → Bearbeiten von ppt/slides/slideN.xml → Packen |
| Inhalte lesen | markitdown deck.pptx (ein Block pro Folie unter <!-- Slide number: N -->-Markierungen); visuelles Raster: python scripts/thumbnail.py deck.pptx |
Skripte
Die Pfade sind relativ zum Verzeichnis dieser Fähigkeit. Alles andere ist reines Python, node oder Shell.
| Skript | Aufgabe |
|---|---|
scripts/thumbnail.py deck.pptx [prefix] | Beschriftetes Raster jeder Folie zur Auswahl von Vorlagenlayouts. Nur .pptx. Optional prefix übergeben – Standard ist thumbnails, was die Raster anderer Präsentationen im selben Verzeichnis überschreibt |
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml] | Dupliziert eine Folie (oder eine slideLayoutN.xml) mit der gesamten Paketverwaltung. Funktioniert auch direkt mit einer .pptx-Datei mit -o out.pptx |
scripts/clean.py unpacked/ | Löscht nicht mehr referenzierte Folien, Medien und Beziehungen. Nach Fertigstellung von <p:sldIdLst> ausführen |
scripts/office/validate.py deck.pptx [--original src.pptx] | Schema-, Beziehungs-, Inhaltstyp-, Diagramm- und Folienprüfungen; jeder Fehler benennt seine Behebung. --original für jede aus einer Vorlage erstellte Präsentation – es vergleicht die Schema-Prüfungen mit der Vorlage, sodass eigene XSD-Fehler der Vorlage nicht als Ihre eigenen gemeldet werden |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx | LibreOffice-Wrapper – nacktes soffice hängt in dieser Sandbox |
Erstellen mit pptxgenjs – Fallstricke
pptxgenjs ist vorinstalliert – führen Sie nicht npm install aus; schreiben Sie das Skript und verwenden Sie require('pptxgenjs') direkt. Nur wenn dieser Require fehlschlägt: npm install pptxgenjs. Das Modell kennt die API; dies sind die Stolperfallen:
- Setzen Sie
pres.layoutvor dem Hinzufügen von Folien. Die Standardleinwand istLAYOUT_16x9= 10" × 5,625", nicht 13,3" breit. Koordinaten jenseits des Randes werden geschrieben, nicht abgeschnitten – die Form ist einfach nicht auf der Folie. (LAYOUT_WIDEist 13,3" × 7,5".) - Hex-Farben: niemals
#, niemals 8 Ziffern.color: "FF0000". Sowohl"#FF0000"als auch Alpha in der Hex-Zahl ("00000020") beschädigen die Datei. Für Transluzenz:transparency: 0-100bei Füllungen und Bildern,opacity: 0,0-1,0bei Schatten – jeweils wird die andere Option stillschweigend ignoriert. - pptxgenjs mutiert Optionsobjekte an Ort und Stelle (wandelt Werte beim ersten Gebrauch in EMU um). Teilen Sie niemals ein
shadow-/Optionsobjekt zwischen zweiadd*-Aufrufen – erstellen Sie jedes Mal ein neues Objekt. - Schatten-
offsetmuss ≥ 0 sein – ein negativer Offset beschädigt die Datei. Um einen Schatten nach oben zu werfen, verwenden Sieangle: 270mit einem positiven Offset. letterSpacingwird stillschweigend ignoriert – die korrekte Option istcharSpacing.- Listen:
bullet: truebei jedem Element, niemals ein wörtliches•(führt zu doppelten Aufzählungszeichen). Setzen SiebreakLine: truebei jedem Array-Element außer dem letzten. Abstände zwischen Aufzählungsabsätzen mitparaSpaceAfter, nicht mitlineSpacing(große Lücken). - Ein
new pptxgen()pro Ausgabedatei – Instanz niemals wiederverwenden. rectRadiusfunktioniert nur beiROUNDED_RECTANGLE, nicht beiRECTANGLE.- Verlaufsfüllungen werden nicht unterstützt – stattdessen ein Verlaufsbild als Hintergrund verwenden.
- Textfelder haben eingebauten Innenabstand – setzen Sie
margin: 0, wenn Text an derselben x-Position mit einer Form, Linie oder einem Symbol ausgerichtet sein muss. - Sprechernotzen kommen in
slide.addNotes("...")(Klartext, einmal pro Folie), niemals in einem Textfeld auf der Folie. - Halten Sie Diagramme nativ. Verwenden Sie
addChart()für alles, was PowerPoint als Diagramm darstellen kann (übergeben Sie ein Array von{type, data, options}für Kombinationen). Für PowerPoint-native Funktionen, die die Bibliothek nicht bereitstellt (Trendlinien, Fehlerbalken), berechnen Sie die zusätzliche Serie selbst oder bearbeiten Sie das generierte OOXML nach – verwenden Sie kein gerendertes Bild. Nur Diagrammtypen, für die PowerPoint keine native Form hat (Sankey, Netzwerk, Chord), werden als Bilder eingefügt. - Standarddiagramme werden nackt gerendert – kein Titel, keine Datenbeschriftungen, veraltete Palette. Setzen Sie
showTitle+title,showValue: true+dataLabelPosition,chartColors: [...]aus Ihrer Palette, und beruhigen Sie den Rahmen (catAxisLabelColor/valAxisLabelColor,valGridLine: { color, size },catGridLine: { style: "none" },showLegend: falsefür eine einzelne Serie). - Bei einem gestapelten Balken- oder Säulendiagramm muss
dataLabelPositionctr,inEndoderinBasesein.outEndbeschädigt die Datei. - Eine Kombinationsserie mit
secondaryValAxis/secondaryCatAxisbenötigt sowohlvalAxesals auchcatAxesin den Diagrammoptionen, jeweils zwei Einträge. Ohne diese schreibt pptxgenjs Achsen-IDs, die es nie deklariert, und PowerPoint verwirft dieses Diagramm und meldet die Datei als beschädigt. NurvalAxesanzugeben, reicht nicht. - Nach
writeFile()führen Siepython scripts/office/validate.py deck.pptxaus. Es meldet die beiden oben genannten Diagrammfehler und diejenigen Folien-XML-Defekte, die PowerPoint ablehnt, und benennt die Behebung für jeden. Beheben Sie sie in Ihrem Generator, nicht durch manuelle Bearbeitung des gepackten XML. - Ordnen Sie die Kinder von
<p:presentation>niemals um. pptxgenjs schreibt<p:notesMasterIdLst>direkt nach<p:sldIdLst>und verweist beide Master auf einen Themen-Teil. PowerPoint liest das problemlos – verschieben Sie das Element und dieselbe Präsentation wird nicht mehr geöffnet. - Symbole: Rendern Sie
react-iconszu SVG (ReactDOMServer.renderToStaticMarkup), rastern Sie mitsharpbei ≥256px und fügen Sie überaddImage({ data: "image/png;base64," + buf.toString("base64") })ein – das Präfiximage/png;base64,ist erforderlich (react-icons,react,react-domundsharpsind vorinstalliert –npm install react-icons react react-dom sharpnur, wenn ein Require fehlschlägt).
Bearbeiten vorhandener Präsentationen und Vorlagen
Wählen Sie zuerst Layouts aus: python scripts/thumbnail.py template.pptx template-thumbs schreibt ein beschriftetes Raster jeder Folie und gibt die erstellte(n) Datei(en) aus – template-thumbs.jpg, aufgeteilt in template-thumbs-N.jpg ab 12 Folien. Übergeben Sie immer das zweite Argument, benannt nach der Präsentation. Standard ist thumbnails, sodass zwei in einem Verzeichnis erstellte Folienraster sich gegenseitig überschreiben – das Raster der ersten Präsentation ist einfach weg (Vorlagenanalyse nur – visuelle Qualitätssicherung benötigt die vollauflösenden Renderings aus Konvertieren in Bilder; es akzeptiert nur .pptx, kopieren Sie also zuerst eine .potx in einen .pptx-Namen). Verwenden Sie es mit markitdown, um jeden Inhaltsabschnitt einer Vorlagenfolie zuzuordnen, und variieren Sie die Layouts – platzieren Sie nicht jeden Abschnitt auf derselben Titel-und-Aufzählungsfolie.
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml # eine Folie duplizieren (oder slideLayoutN.xml); gibt den Pfad der neuen Folie aus
# Folien neu anordnen / löschen = <p:sldIdLst> in ppt/presentation.xml bearbeiten
python scripts/clean.py unpacked/ # nach dem Löschen: entfernt verwaiste Folien, Medien, Beziehungen
# Folieninhalt in ppt/slides/slideN.xml bearbeiten
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .) # zip VON INNERHALB des Verzeichnisses; rm zuerst, sonst bleiben gelöschte Teile erhalten
python scripts/office/validate.py out.pptx --original deck.pptx
- Führen Sie alle strukturellen Arbeiten – Hinzufügen, Löschen, Neuordnen – durch, bevor Sie den Inhalt einer Folie bearbeiten.
add_slide.pykopiert eine Folien-Datei wörtlich, sodass das Duplizieren nach der Bearbeitung den bearbeiteten Inhalt klont; undclean.pylöscht jede Folie, die in<p:sldIdLst>fehlt, einschließlich einer, die Sie gerade geschrieben haben. - Kopieren Sie niemals eine Folien-Datei manuell –
add_slide.pyführt jede Registrierung durch, die eine neue Folie benötigt, und meldet, was erstellt wurde (Created ppt/slides/slide17.xml from slide2.xml). Es funktioniert auch direkt mit einer Datei:add_slide.py deck.pptx slide2.xml -o out.pptx– übergeben Sie-o, sonst überschreibt es die Eingabe-Präsentation an Ort und Stelle. Eine duplizierte Folie referenziert weiterhin die Diagramm-/SmartArt-/Eingebettetes-Objekt-Teile ihrer Quelle, anstatt sie zu klonen. Das Bearbeiten des Diagramms einer Folie ändert also das der anderen. - Wenn Sie
python-pptxverwenden, kann es drei Dinge nicht: eine Folie duplizieren (sein einziger Einstiegspunkt istadd_slide(layout)), die Formatierung durchtext_frame.text = "..."beibehalten (das reduziert den Absatz auf einen einzigen unformatierten Lauf – verwenden Sie stattdessenrun.text), oder das SVG/EMF lesen, das die meisten Vorlagen-Grafiken verwenden (add_picturelöstUnidentifiedImageErroraus). - Legacy
.pptmuss zuerst konvertiert werden:python scripts/office/soffice.py --headless --convert-to pptx file.ppt..potx-Vorlagen werden identisch entpackt und verpackt – behalten Sie die Erweiterung.potxin der Ausgabe bei. - Um ein Vorlagensymbol oder -bild wiederzuverwenden, duplizieren Sie eine Folie oder ein Layout, das es bereits enthält.
Beim Ausfüllen einer Vorlage:
- Wenn Sie eine XML-Transformation skripten, parsen Sie mit
defusedxml.minidom– das Hin- und Rückwandeln von OOXML durchxml.etree.ElementTreeschreibt Namespace-Präfixe um und beschädigt die Präsentation. - Vorlagen-Platzhalter ≠ Quell-Elemente. Wenn die Vorlage 4 Teammitglieder zeigt und Sie 3 haben, löschen Sie die gesamte Gruppe des 4. Mitglieds (Bild + Textfelder), nicht nur den Text – überprüfen Sie dann in der Qualitätssicherung auf verwaiste visuelle Elemente.
- Ein
<a:p>pro Listenelement – verketten Sie niemals Elemente in einem einzigen Absatz. Kopieren Sie das gleichgeordnete<a:pPr>, um Abstände zu erhalten, und setzen Sieb="1"auf das<a:rPr>von Titeln, Abschnittsüberschriften und Inline-Labels (Status:,Besitzer:). - Lassen Sie Aufzählungszeichen vom Layout erben; fügen Sie nur
<a:buChar>,<a:buAutoNum>(nummeriert) oder<a:buNone>hinzu, um zu überschreiben – niemals ein wörtliches•im Text. - Text mit führenden oder abschließenden Leerzeichen benötigt
xml:space="preserve"auf seinem<a:t>.
Designideen
Erstellen Sie keine langweiligen Folien. Einfache Aufzählungszeichen auf weißem Hintergrund beeindrucken niemanden. Ziehen Sie für jede Folie Ideen aus dieser Liste in Betracht.
Vor dem Start
- Wählen Sie eine kräftige, inhaltsbezogene Farbpalette: Die Palette sollte sich anfühlen, als wäre sie für DIESES Thema entworfen. Wenn das Austauschen Ihrer Farben in eine völlig andere Präsentation immer noch "funktionieren" würde, haben Sie keine spezifischen Entscheidungen getroffen.
- Dominanz vor Gleichheit: Eine Farbe sollte dominieren (60-70 % visuelles Gewicht), mit 1-2 unterstützenden Tönen und einem scharfen Akzent. Geben Sie niemals allen Farben das gleiche Gewicht.
- Dunkel/Hell-Kontrast: Dunkle Hintergründe für Titel- und Schlussfolien, helle für Inhalte („Sandwich“-Struktur). Oder durchgängig dunkel für ein hochwertiges Gefühl.
- Legen Sie ein visuelles Motiv fest: Wählen Sie EIN charakteristisches Element aus und wiederholen Sie es – abgerundete Bildrahmen, Symbole in farbigen Kreisen. Ziehen Sie es durch jede Folie. Verwenden Sie keinen Farbbalken oder Akzentstreifen als Ihr Motiv (siehe Liste der zu vermeidenden Dinge).
Farbpaletten
Wählen Sie Farben passend zu Ihrem Thema – verwenden Sie nicht standardmäßig Blau. Verwenden Sie diese Paletten als Inspiration:
| Thema | Primär | Sekundär | Akzent |
|---|---|---|---|
| Mitternachts-Executive | 1E2761 (marineblau) | CADCFC (eisblau) | FFFFFF (weiß) |
| Wald & Moos | 2C5F2D (waldgrün) | 97BC62 (moosgrün) | F5F5F5 (creme) |
| Korallen-Energie | F96167 (koralle) | F9E795 (gold) | 2F3C7E (marineblau) |
| Warmer Terrakotta | B85042 (terrakotta) | E7E8D1 (sand) | A7BEAE (salbei) |
| Ozean-Verlauf | 065A82 (dunkelblau) | 1C7293 (türkis) | 21295C (mitternachtsblau) |
| Kohle-Minimal | 36454F (kohle) | F2F2F2 (off-white) | 212121 (schwarz) |
| Teal-Vertrauen | 028090 (blaugrün) | 00A896 (seegrün) | 02C39A (minze) |
| Beere & Creme | 6D2E46 (beere) | A26769 (altrosa) | ECE2D0 (creme) |
| Salbei-Ruhe | 84B59F (salbei) | 69A297 (eukalyptus) | 50808E (schiefer) |
| Kirsch-Kühn | 990011 (kirsche) | FCF6F5 (off-white) | 2F3C7E (marineblau) |
Für jede Folie
Jede Folie benötigt ein visuelles Element – Bild, Diagramm, Symbol oder Form. Nur-Text-Folien sind vergesslich.
Layout-Optionen:
- Zwei Spalten (Text links, Illustration rechts)
- Symbol + Textzeilen (Symbol im farbigen Kreis, fette Überschrift, Beschreibung darunter)
- 2×2- oder 2×3-Raster (Bild auf einer Seite, Raster von Inhaltsblöcken auf der anderen)
- Halbseitig auslaufendes Bild (volle linke oder rechte Seite) mit Content-Overlay
Datenanzeige:
- Große Zahlen-Highlights (große Zahlen 60–72 pt mit kleinen Labels darunter)
- Vergleichsspalten (vorher/nachher, pro/kontra, nebeneinanderliegende Optionen)
- Zeitleiste oder Prozessablauf (nummerierte Schritte, Pfeile)
Visuelle Verfeinerung:
- Symbole in kleinen farbigen Kreisen neben Abschnittsüberschriften
- Kursiver Akzenttext für wichtige Statistiken oder Slogans
Typografie
Schriftnamen, die Sie in die .pptx schreiben, werden von PowerPoint des Benutzers gerendert, nicht von dieser Umgebung. Ihre visuelle Qualitätssicherung rendert über LibreOffice, das Schriftarten, die es nicht hat, durch Ersatzschriftarten ersetzt – und für einige Schriftarten hat die Ersatzschriftart andere Breiten, sodass Ihre QA-Vorschau Textüberlauf (oder Passform) anzeigen kann, den die echte Präsentation nicht haben wird. Um Ihre QA vertrauenswürdig zu halten:
- Sichere Schriftarten (rendern in QA maßstabsgetreu und sind mit Office ausgeliefert): Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Verwenden Sie diese für Fließtext und alles, bei dem die Passform wichtig ist.
- Überschriften mit Persönlichkeit bei null QA-Risiko: Kombinieren Sie eine Serifen-Überschrift aus der sicheren Liste (Cambria, Bookman Old Style, Century Schoolbook) mit einem serifenlosen Textkörper aus der sicheren Liste (Calibri oder Arial). Sie erhalten visuellen Kontrast, ohne auf zuverlässige Überlaufprüfungen verzichten zu müssen.
- Wenn der Benutzer eine Schriftart außerhalb der sicheren Liste verlangt (z. B. Georgia oder Trebuchet MS): Verwenden Sie sie dort, wo der Benutzer es verlangt hat, aber dimensionieren Sie diese Container mit zusätzlichem Spielraum (~10 %) und vertrauen Sie nicht auf die QA-Textpassform für diese Elemente – die Vorschau dieser Schriftart ist ungefähr. Wenn der Benutzer nichts angegeben hat, bevorzugen Sie Schriftarten aus der sicheren Liste für Fließtext.
- QA-unzuverlässige Schriftarten (Ersatzschrift hat andere Breiten – Überlaufprüfungen können falsch sein): Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. Die Ersetzung von Calibri Light variiert je nach Umgebung; behandeln Sie sie als QA-unzuverlässig. Gut für Titel/Akzente mit Spielraum; vertrauen Sie nicht auf die QA-Textpassform bei diesen.
- Niemals standardmäßig auf Aptos zurückgreifen – Office-Standard nach 2023 hat hier keinen metrikkompatiblen Ersatz und fehlt in älteren Office-Installationen, daher ist es auf beiden Seiten unzuverlässig.
| Element | Größe |
|---|---|
| Folientitel | 36–44 pt fett |
| Abschnittsüberschrift | 20–24 pt fett |
| Fließtext | 14–16 pt |
| Bildunterschriften | 10–12 pt dezent |
…
[gekürzt zur Übersetzung]