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 |
|---|---|
| Neue Präsentation erstellen | Ein pptxgenjs-Skript schreiben – siehe Hinweise unten |
| Vorhandene Präsentation bearbeiten oder aus einer Vorlage erstellen | Entpacken → ppt/slides/slideN.xml bearbeiten → packen |
| Inhalt lesen | markitdown deck.pptx (ein Block pro Folie unter <!-- Slide number: N -->-Markierungen); visuelles Raster: python scripts/thumbnail.py deck.pptx |
Skripte
Die Pfade beziehen sich auf das Verzeichnis dieser Fähigkeit. Alles andere ist normales Python, node oder Shell.
| Skript | Funktion |
|---|---|
scripts/thumbnail.py deck.pptx [präfix] | Beschriftetes Raster jeder Folie zum Auswählen von Vorlagenlayouts. Nur .pptx. präfix übergeben – standardmäßig thumbnails, was die Raster anderer Präsentationen im selben Verzeichnis überschreibt |
scripts/add_slide.py entpackt/ slide2.xml [--after slideN.xml] | Dupliziert eine Folie (oder eine slideLayoutN.xml) mit der gesamten Paketverwaltung. Akzeptiert auch direkt eine .pptx mit -o out.pptx |
scripts/clean.py entpackt/ | Löscht nicht mehr referenzierte Folien, Medien und rels. Nachdem <p:sldIdLst> endgültig ist, ausführen |
scripts/office/validate.py deck.pptx [--original src.pptx] | Schema-, Beziehungs-, Content-Type-, Diagramm- und Folienprüfungen; jeder Fehler nennt seine Behebung. --original für jede aus einer Vorlage abgeleitete Präsentation übergeben – es setzt die Schema-Prüfungen gegen die Vorlage, sodass deren eigene XSD-Fehler nicht als Ihre erscheinen |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx | LibreOffice-Wrapper – reines soffice hängt in dieser Sandbox |
Erstellen mit pptxgenjs – Hinweise
pptxgenjs ist vorinstalliert – führen Sie nicht zuerst 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; hier sind die Fallstricke:
- Setzen Sie
pres.layoutvor dem Hinzufügen von Folien. Die Standardleinwand istLAYOUT_16x9= 10" × 5,625", nicht 13,3" breit. Koordinaten über den Rand hinaus werden geschrieben, nicht abgeschnitten – die Form ist dann 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 Hex enthalten ("00000020") beschädigen die Datei. Für Transluzenz:transparency: 0-100bei Füllungen und Bildern,opacity: 0.0-1.0bei Schatten – jeder wird auf dem anderen still ignoriert. - pptxgenjs mutiert Optionsobjekte direkt (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 still ignoriert – die richtige 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. Abstand von Aufzählungsabsätzen mitparaSpaceAfter, nichtlineSpacing(große Lücken). - Ein
new pptxgen()pro Ausgabedatei – niemals eine Instanz wiederverwenden. rectRadiusfunktioniert nur aufROUNDED_RECTANGLE, nicht aufRECTANGLE.- Gradient-Füllungen werden nicht unterstützt – verwenden Sie stattdessen ein Gradientenbild als Hintergrund.
- Textfelder haben eingebaute Innenabstände – setzen Sie
margin: 0, wenn Text mit einer Form, Linie oder einem Symbol auf derselben x-Position ausgerichtet sein soll. - Sprechernotizen 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 – greifen Sie nicht auf ein gerendertes Bild zurück. Nur Diagrammtypen, für die PowerPoint keine native Form hat (Sankey, Netzwerk, Chord), werden als Bilder eingefügt. - Standard-Diagramme sind schlicht – 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, die
secondaryValAxis/secondaryCatAxisverwendet, benötigt sowohlvalAxesals auchcatAxesin den Diagrammoptionen, jeweils zwei Einträge. Ohne sie schreibt pptxgenjs Achsen-IDs, die es nie deklariert, und PowerPoint verwirft dieses Diagramm und meldet die Datei als beschädigt. NurvalAxesanzugeben, reicht nicht. - Führen Sie nach
writeFile()das Skriptpython scripts/office/validate.py deck.pptxaus. Es meldet die beiden oben genannten Diagrammfehler und die Folien-XML-Defekte, die PowerPoint ablehnt, und nennt für jeden die Behebung. Beheben Sie sie in Ihrem Generator, nicht durch manuelle Bearbeitung der 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 Theme-Teil. PowerPoint liest das problemlos – verschieben Sie das Element und dieselbe Präsentation wird unöffnbar. - Symbole: Rendern Sie
react-iconsin 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).
Vorhandene Präsentationen und Vorlagen bearbeiten
Layouts zuerst auswählen: python scripts/thumbnail.py vorlage.pptx vorlage-thumbs schreibt ein beschriftetes Raster jeder Folie und gibt die erstellte(n) Datei(en) aus – vorlage-thumbs.jpg, aufgeteilt in vorlage-thumbs-N.jpg ab 12 Folien. Übergeben Sie immer dieses zweite Argument, benannt nach der Präsentation. Es standardmäßig auf thumbnails, sodass zwei in einem Verzeichnis erstellte Miniaturansichten stillschweigend die Raster des jeweils anderen überschreiben – die Raster der ersten Präsentation sind einfach weg (nur Vorlagenanalyse – die visuelle Qualitätskontrolle benötigt die vollauflösenden Renderings von In Bilder konvertieren; es akzeptiert nur .pptx, also kopieren Sie zuerst eine .potx in einen .pptx-Namen). Verwenden Sie es mit markitdown, um jeden Inhaltsabschnitt einer Vorlagenfolie zuzuordnen, und variieren Sie die Layouts – setzen Sie nicht jeden Abschnitt auf dieselbe Titel-und-Aufzählungszeichen-Folie.
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('entpackt')" deck.pptx
python scripts/add_slide.py entpackt/ slide2.xml --after slide2.xml # eine Folie (oder slideLayoutN.xml) duplizieren; gibt den Pfad der neuen Folie aus
# Folien neu anordnen / löschen = <p:sldIdLst> in ppt/presentation.xml bearbeiten
python scripts/clean.py entpackt/ # nach Löschungen: entfernt verwaiste Folien, Medien, rels
# Folieninhalt in ppt/slides/slideN.xml bearbeiten
(cd entpackt && rm -f ../out.pptx && zip -Xr ../out.pptx .) # zip von INNERHALB des Verzeichnisses; zuerst rm, sonst überleben gelöschte Teile
python scripts/office/validate.py out.pptx --original deck.pptx
- Führen Sie alle strukturellen Arbeiten – hinzufügen, löschen, neu anordnen – durch, bevor Sie den Inhalt einer Folie bearbeiten.
add_slide.pykopiert eine Folie wörtlich, sodass das Duplizieren nach einer 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 Folie von Hand –
add_slide.pyerledigt jede Registrierung, die eine neue Folie benötigt, und meldet, was erstellt wurde (Erstellt ppt/slides/slide17.xml aus slide2.xml). Es funktioniert auch direkt mit einer Datei:add_slide.py deck.pptx slide2.xml -o out.pptx– übergeben Sie-o, sonst wird die Eingabe-Präsentation direkt überschrieben. Eine duplizierte Folie referenziert immer noch die Diagramm-/SmartArt-/Eingebettete-Objekt-Teile ihrer Quelle, anstatt sie zu klonen, sodass die Bearbeitung des Diagramms einer Folie das der anderen ändert. - Wenn Sie
python-pptxverwenden, drei Dinge, die es nicht kann: eine Folie duplizieren (sein einziger Einstiegspunkt istadd_slide(layout)), die Formatierung durchtext_frame.text = "..."bewahren (das reduziert den Absatz auf einen einzigen unformatierten Lauf – weisen Sie stattdessenrun.textzu) oder das SVG/EMF lesen, das die meisten Vorlagengrafiken verwenden (add_picturewirftUnidentifiedImageError). - Legacy
.pptmuss zuerst konvertiert werden:python scripts/office/soffice.py --headless --convert-to pptx datei.ppt..potx-Vorlagen werden identisch entpackt und gepackt – behalten Sie die.potx-Erweiterung in der Ausgabe. - 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. - Vorlagenplätze ≠ Quellenelemente. Wenn die Vorlage 4 Teammitglieder zeigt und Sie 3 haben, löschen Sie die gesamte Gruppe des 4. Mitglieds (Bild + Textfelder), nicht nur seinen Text – überprüfen Sie dann in der Qualitätskontrolle auf verwaiste visuelle Elemente.
- Ein
<a:p>pro Listenelement – verketten Sie niemals Elemente in einem einzigen Absatz. Kopieren Sie das Geschwister-<a:pPr>, um den Abstand zu erhalten, und setzen Sieb="1"auf das<a:rPr>von Titeln, Abschnittsüberschriften und Inline-Beschriftungen (Status:,Eigentümer:). - Lassen Sie Aufzählungszeichen vom Layout erben; fügen Sie nur
<a:buChar>,<a:buAutoNum>(nummeriert) oder<a:buNone>hinzu, um sie zu überschreiben – niemals ein wörtliches•im Text. - Text mit führenden oder nachgestellten Leerzeichen benötigt
xml:space="preserve"in seinem<a:t>.
Design-Ideen
Erstellen Sie keine langweiligen Folien. Einfache Aufzählungszeichen auf weißem Hintergrund werden niemanden beeindrucken. Ziehen Sie Ideen aus dieser Liste für jede Folie in Betracht.
Bevor Sie beginnen
- Wählen Sie eine kräftige, inhaltlich passende Farbpalette: Die Palette sollte sich für DIESES Thema entworfen anfühlen. Wenn das Austauschen Ihrer Farben in eine völlig andere Präsentation immer noch „funktionieren" würde, haben Sie nicht spezifisch genug gewählt.
- 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 gleiches 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 Premium-Gefühl.
- Entscheiden Sie sich für ein visuelles Motiv: Wählen Sie EIN unverwechselbares Element und wiederholen Sie es – abgerundete Bildrahmen, Symbole in farbigen Kreisen. Ziehen Sie es durch jede Folie. Verwenden Sie keinen Farbbalken oder Akzentstreifen als Motiv (siehe Vermeidungsliste).
Farbpaletten
Wählen Sie Farben, die zu Ihrem Thema passen – verwenden Sie nicht standardmäßig generisches Blau. Verwenden Sie diese Paletten als Inspiration:
| Thema | Primär | Sekundär | Akzent |
|---|---|---|---|
| Mitternacht 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) |
| Warmes Terrakotta | B85042 (terrakotta) | E7E8D1 (sand) | A7BEAE (salbei) |
| Ozean-Verlauf | 065A82 (tiefblau) | 1C7293 (türkis) | 21295C (mitternachtsblau) |
| Kohle-Minimal | 36454F (kohle) | F2F2F2 (off-white) | 212121 (schwarz) |
| Teal-Vertrauen | 028090 (teal) | 00A896 (seegrün) | 02C39A (minze) |
| Beere & Creme | 6D2E46 (beere) | A26769 (staubiges rosa) | 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 braucht 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)
- 2x2- oder 2x3-Raster (Bild auf einer Seite, Raster von Inhaltsblöcken auf der anderen)
- Halbseitiges Bild (volle linke oder rechte Seite) mit Inhaltsüberlagerung
Datendarstellung:
- Große Statistik-Highlights (große Zahlen 60-72pt mit kleinen Beschriftungen darunter)
- Vergleichsspalten (vorher/nachher, pro/contra, nebeneinander Optionen)
- Zeitleiste oder Prozessablauf (nummerierte Schritte, Pfeile)
Visuelle Verfeinerung:
- Symbole in kleinen farbigen Kreisen neben Abschnittsüberschriften
- Kurativer 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ätskontrolle rendert über LibreOffice, das Schriftarten, die es nicht hat, ersetzt – und für manche Schriftarten hat der Ersatz unterschiedliche Breiten, sodass Ihre Qualitätskontrolle Textüberlauf (oder Passform) zeigen kann, den die echte Präsentation nicht haben wird. Um Ihre Qualitätskontrolle vertrauenswürdig zu halten:
- Sichere Schriftarten (rendern in der Qualitätskontrolle maßstabsgetreu und sind in Office enthalten): 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 Qualitätskontrollrisiko: Kombinieren Sie eine Serifen-Überschrift aus der sicheren Liste (Cambria, Bookman Old Style, Century Schoolbook) mit einem serifenlosen Fließtext 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 wünscht, aber dimensionieren Sie diese Container mit zusätzlichem Spielraum (~10 %) und vertrauen Sie bei diesen Elementen nicht auf die Textpassform der Qualitätskontrolle – die Vorschau dieser Schriftart ist ungefähr. Wenn der Benutzer keine Angabe gemacht hat, bevorzugen Sie Schriftarten aus der sicheren Liste für Fließtext.
- In der Qualitätskontrolle unzuverlässige Schriftarten (Ersatz hat unterschiedliche 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 es als in der Qualitätskontrolle unzuverlässig. In Ordnung für Titel/Akzente mit Spielraum; vertrauen Sie nicht auf die Textpassform der Qualitätskontrolle bei diesen.
- Niemals standardmäßig Aptos verwenden – Office's Standard nach 2023 hat hier keinen metrisch kompatiblen Ersatz und fehlt in älteren Office-Installationen, ist also auf beiden Seiten unzuverlässig.
| Element | Größe |
|---|---|
| Folientitel | 36-44pt fett |
| Abschnittsüberschrift | 20-24pt fett |
| Fließtext | 14-16pt |
| Bildunterschriften | 10-12pt dezent |
…
[Zugunsten der Übersetzung gekürzt]