Erstellung, Bearbeitung und Analyse von PPTX-Dateien
Überblick
Ein Benutzer kann Sie bitten, den Inhalt einer .pptx-Datei zu erstellen, zu bearbeiten oder zu analysieren. Eine .pptx-Datei ist im Wesentlichen ein ZIP-Archiv mit XML-Dateien und anderen Ressourcen, die Sie lesen oder bearbeiten können. Für verschiedene Aufgaben stehen Ihnen unterschiedliche Tools und Workflows zur Verfügung.
Lesen und Analysieren von Inhalten
Textextraktion
Wenn Sie lediglich den Textinhalt einer Präsentation lesen müssen, sollten Sie das Dokument in Markdown konvertieren:
# Dokument in Markdown konvertieren
python -m markitdown path-to-file.pptx
Roh-XML-Zugriff
Sie benötigen Roh-XML-Zugriff für: Kommentare, Sprechernotizen, Folienlayouts, Animationen, Designelemente und komplexe Formatierungen. Für diese Funktionen müssen Sie eine Präsentation entpacken und den rohen XML-Inhalt lesen.
Entpacken einer Datei
python ooxml/scripts/unpack.py <office_file> <output_dir>
Hinweis: Das Skript unpack.py befindet sich relativ zum Projektstamm unter skills/pptx/ooxml/scripts/unpack.py. Wenn das Skript unter diesem Pfad nicht existiert, verwenden Sie find . -name "unpack.py", um es zu finden.
Wichtige Dateistrukturen
ppt/presentation.xml– Hauptpräsentationsmetadaten und Folienreferenzenppt/slides/slide{N}.xml– Einzelne Folieninhalte (slide1.xml, slide2.xml, usw.)ppt/notesSlides/notesSlide{N}.xml– Sprechernotizen für jede Folieppt/comments/modernComment_*.xml– Kommentare für bestimmte Folienppt/slideLayouts/– Layoutvorlagen für Folienppt/slideMasters/– Master-Folienvorlagenppt/theme/– Design- und Stilinformationenppt/media/– Bilder und andere Mediendateien
Typographie- und Farbextraktion
Wenn Ihnen ein Beispiel-Design zur Nachahmung gegeben wird: Analysieren Sie zuerst die Typographie und Farben der Präsentation mit den folgenden Methoden:
- Design-Datei lesen: Überprüfen Sie
ppt/theme/theme1.xmlauf Farben (<a:clrScheme>) und Schriftarten (<a:fontScheme>) - Beispiel-Folieninhalt: Untersuchen Sie
ppt/slides/slide1.xmlauf tatsächliche Schriftverwendung (<a:rPr>) und Farben - Nach Mustern suchen: Verwenden Sie grep, um Farb- (
<a:solidFill>,<a:srgbClr>) und Schriftverweise in allen XML-Dateien zu finden
Erstellen einer neuen PowerPoint-Präsentation ohne Vorlage
Verwenden Sie beim Erstellen einer neuen PowerPoint-Präsentation von Grund auf den html2pptx-Workflow, um HTML-Folien mit genauer Positionierung in PowerPoint zu konvertieren.
Designprinzipien
KRITISCH: Analysieren Sie vor der Erstellung einer Präsentation den Inhalt und wählen Sie geeignete Designelemente:
- Berücksichtigen Sie den Gegenstand: Worum geht es in dieser Präsentation? Welchen Ton, welche Branche oder welche Stimmung legt das Thema nahe?
- Auf Branding prüfen: Wenn der Benutzer ein Unternehmen/eine Organisation erwähnt, berücksichtigen Sie deren Markenfarben und Identität
- Palette an den Inhalt anpassen: Wählen Sie Farben, die das Thema widerspiegeln
- Legen Sie Ihren Ansatz dar: Erklären Sie Ihre Designentscheidungen, bevor Sie Code schreiben
Anforderungen:
- ✅ Legen Sie Ihren inhaltsbasierten Designansatz DAR, bevor Sie Code schreiben
- ✅ Verwenden Sie nur websichere Schriftarten: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
- ✅ Schaffen Sie eine klare visuelle Hierarchie durch Größe, Gewicht und Farbe
- ✅ Stellen Sie Lesbarkeit sicher: starker Kontrast, angemessen große Texte, saubere Ausrichtung
- ✅ Seien Sie konsistent: Wiederholen Sie Muster, Abstände und visuelle Sprache auf allen Folien
Farbpalettenauswahl
Farben kreativ auswählen:
- Über Standard hinausdenken: Welche Farben passen wirklich zu diesem spezifischen Thema? Vermeiden Sie Standardentscheidungen.
- Mehrere Blickwinkel berücksichtigen: Thema, Branche, Stimmung, Energielevel, Zielgruppe, Markenidentität (falls erwähnt)
- Seien Sie abenteuerlustig: Probieren Sie unerwartete Kombinationen – eine Gesundheitspräsentation muss nicht grün sein, Finanzen müssen nicht marineblau sein
- Bauen Sie Ihre Palette auf: Wählen Sie 3-5 Farben, die zusammenpassen (dominante Farben + unterstützende Töne + Akzent)
- Kontrast sicherstellen: Text muss auf Hintergründen klar lesbar sein
Beispiel-Farbpaletten (verwenden Sie diese als Inspiration – wählen Sie eine aus, passen Sie sie an oder erstellen Sie Ihre eigene):
- Klassisches Blau: Dunkles Marineblau (#1C2833), Schiefergrau (#2E4053), Silber (#AAB7B8), Cremeweiß (#F4F6F6)
- Blaugrün & Koralle: Blaugrün (#5EA8A7), Dunkelblaugrün (#277884), Koralle (#FE4447), Weiß (#FFFFFF)
- Kräftiges Rot: Rot (#C0392B), Hellrot (#E74C3C), Orange (#F39C12), Gelb (#F1C40F), Grün (#2ECC71)
- Warmer Rosé: Mauve (#A49393), Rosé (#EED6D3), Rosa (#E8B4B8), Creme (#FAF7F2)
- Burgunder-Luxus: Burgunder (#5D1D2E), Karminrot (#951233), Rost (#C15937), Gold (#997929)
- Tiefes Lila & Smaragd: Lila (#B165FB), Dunkelblau (#181B24), Smaragd (#40695B), Weiß (#FFFFFF)
- Creme & Waldgrün: Creme (#FFE1C7), Waldgrün (#40695B), Weiß (#FCFCFC)
- Pink & Lila: Pink (#F8275B), Koralle (#FF574A), Rose (#FF737D), Lila (#3D2F68)
- Limette & Pflaume: Limette (#C5DE82), Pflaume (#7C3A5F), Koralle (#FD8C6E), Blaugrau (#98ACB5)
- Schwarz & Gold: Gold (#BF9A4A), Schwarz (#000000), Creme (#F4F6F6)
- Salbei & Terrakotta: Salbei (#87A96B), Terrakotta (#E07A5F), Creme (#F4F1DE), Holzkohle (#2C2C2C)
- Holzkohle & Rot: Holzkohle (#292929), Rot (#E33737), Hellgrau (#CCCBCB)
- Lebendiges Orange: Orange (#F96D00), Hellgrau (#F2F2F2), Holzkohle (#222831)
- Waldgrün: Schwarz (#191A19), Grün (#4E9F3D), Dunkelgrün (#1E5128), Weiß (#FFFFFF)
- Retro-Regenbogen: Lila (#722880), Pink (#D72D51), Orange (#EB5C18), Bernstein (#F08800), Gold (#DEB600)
- Vintage-Erdig: Senf (#E3B448), Salbei (#CBD18F), Waldgrün (#3A6B35), Creme (#F4F1DE)
- Küstenrose: Altrosa (#AD7670), Biber (#B49886), Eierschale (#F3ECDC), Aschgrau (#BFD5BE)
- Orange & Türkis: Hellorange (#FC993E), Grautürkis (#667C6F), Weiß (#FCFCFC)
Optionen für visuelle Details
Geometrische Muster:
- Diagonale Abschnittstrennlinien anstelle von horizontalen
- Asymmetrische Spaltenbreiten (30/70, 40/60, 25/75)
- Gedrehte Textüberschriften um 90° oder 270°
- Kreisförmige/sechseckige Rahmen für Bilder
- Dreieckige Akzentformen in Ecken
- Überlappende Formen für Tiefe
Rahmen- & Umrandungsbehandlungen:
- Dicke einfarbige Ränder (10-20pt) nur auf einer Seite
- Doppellinienränder mit kontrastierenden Farben
- Eckklammern anstelle von vollständigen Rahmen
- L-förmige Ränder (oben+links oder unten+rechts)
- Unterstreichungsakzente unter Überschriften (3-5pt dick)
Typografische Behandlungen:
- Extremen Größenkontrast (72pt Überschriften vs. 11pt Fließtext)
- Überschriften in Großbuchstaben mit weitem Buchstabenabstand
- Nummerierte Abschnitte in übergroßer Darstellungsschrift
- Monospace (Courier New) für Daten/Statistiken/technische Inhalte
- Kondensierte Schriftarten (Arial Narrow) für dichte Informationen
- Konturierter Text zur Hervorhebung
Diagramm- & Datenstil:
- Monochrome Diagramme mit einer einzigen Akzentfarbe für Schlüsseldaten
- Horizontale Balkendiagramme anstelle von vertikalen
- Punktdiagramme anstelle von Balkendiagrammen
- Minimale Gitterlinien oder gar keine
- Datenbeschriftungen direkt auf Elementen (keine Legenden)
- Übergroße Zahlen für wichtige Kennzahlen
Layout-Innovationen:
- Vollflächige Bilder mit Textüberlagerungen
- Seitenleiste (20-30% Breite) für Navigation/Kontext
- Modulare Rastersysteme (3×3, 4×4 Blöcke)
- Z-Muster oder F-Muster Inhaltsfluss
- Schweben von Textfeldern über farbigen Formen
- Mehrspaltige Layouts im Magazinstil
Hintergrundbehandlungen:
- Solide Farbblöcke, die 40-60% der Folie einnehmen
- Verlaufsfüllungen (nur vertikal oder diagonal)
- Geteilte Hintergründe (zwei Farben, diagonal oder vertikal)
- Durchgehende Farbbänder von Kante zu Kante
- Negativraum als Designelement
Layout-Tipps
Beim Erstellen von Folien mit Diagrammen oder Tabellen:
- Zweispaltiges Layout (BEVORZUGT): Verwenden Sie eine Kopfzeile, die die gesamte Breite einnimmt, dann zwei Spalten darunter – Text/Aufzählungspunkte in einer Spalte und den hervorgehobenen Inhalt in der anderen. Dies sorgt für ein besseres Gleichgewicht und macht Diagramme/Tabellen lesbarer. Verwenden Sie Flexbox mit ungleichen Spaltenbreiten (z. B. 40%/60% Aufteilung), um den Platz für jeden Inhaltstyp zu optimieren.
- Vollfolien-Layout: Lassen Sie den hervorgehobenen Inhalt (Diagramm/Tabelle) die gesamte Folie einnehmen, um maximale Wirkung und Lesbarkeit zu erzielen.
- NIE vertikal stapeln: Platzieren Sie Diagramme/Tabellen nicht unter Text in einer einzigen Spalte – dies führt zu schlechter Lesbarkeit und Layout-Problemen.
Workflow
- VERPFLICHTEND – GANZE DATEI LESEN: Lesen Sie
html2pptx.mdvollständig von Anfang bis Ende. Setzen Sie beim Lesen dieser Datei NIE Bereichsgrenzen. Lesen Sie den vollständigen Dateiinhalt für detaillierte Syntax, kritische Formatierungsregeln und bewährte Verfahren, bevor Sie mit der Präsentationserstellung fortfahren. - Erstellen Sie eine HTML-Datei für jede Folie mit den richtigen Abmessungen (z. B. 720pt × 405pt für 16:9)
- Verwenden Sie
<p>,<h1>-<h6>,<ul>,<ol>für den gesamten Textinhalt. - Verwenden Sie
class="placeholder"für Bereiche, in denen Diagramme/Tabellen hinzugefügt werden (zur besseren Sichtbarkeit mit grauem Hintergrund rendern). - KRITISCH: Rastern Sie Verläufe und Symbole zuerst mit Sharp als PNG-Bilder, dann verweisen Sie im HTML darauf.
- LAYOUT: Verwenden Sie für Folien mit Diagrammen/Tabellen/Bildern entweder das Vollfolien-Layout oder das zweispaltige Layout für bessere Lesbarkeit.
- Verwenden Sie
- Erstellen und führen Sie eine JavaScript-Datei mit der Bibliothek
html2pptx.jsaus, um HTML-Folien in PowerPoint zu konvertieren und die Präsentation zu speichern.- Verwenden Sie die Funktion
html2pptx(), um jede HTML-Datei zu verarbeiten. - Fügen Sie Diagramme und Tabellen zu Platzhalterbereichen mit der PptxGenJS-API hinzu.
- Speichern Sie die Präsentation mit
pptx.writeFile().
- Verwenden Sie die Funktion
- Visuelle Validierung: Erstellen Sie Thumbnails und prüfen Sie diese auf Layout-Probleme.
- Thumbnail-Raster erstellen:
python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 - Lesen und untersuchen Sie das Thumbnail-Bild sorgfältig auf:
- Abgeschnittener Text: Text, der durch Kopfzeilen, Formen oder Folienränder abgeschnitten wird.
- Textüberlappung: Text, der mit anderem Text oder anderen Formen überlappt.
- Positionierungsprobleme: Inhalt, der zu nah an Folienrändern oder anderen Elementen ist.
- Kontrastprobleme: Unzureichender Kontrast zwischen Text und Hintergründen.
- Wenn Probleme gefunden werden, passen Sie die HTML-Ränder/Abstände/Farben an und generieren Sie die Präsentation neu.
- Wiederholen Sie den Vorgang, bis alle Folien visuell korrekt sind.
- Thumbnail-Raster erstellen:
Bearbeiten einer vorhandenen PowerPoint-Präsentation
Beim Bearbeiten von Folien in einer vorhandenen PowerPoint-Präsentation müssen Sie mit dem rohen Office Open XML (OOXML)-Format arbeiten. Dabei wird die .pptx-Datei entpackt, der XML-Inhalt bearbeitet und wieder verpackt.
Workflow
- VERPFLICHTEND – GANZE DATEI LESEN: Lesen Sie
ooxml.md(~500 Zeilen) vollständig von Anfang bis Ende. Setzen Sie beim Lesen dieser Datei NIE Bereichsgrenzen. Lesen Sie den vollständigen Dateiinhalt für detaillierte Anleitungen zur OOXML-Struktur und Bearbeitungsworkflows, bevor Sie eine Präsentation bearbeiten. - Entpacken Sie die Präsentation:
python ooxml/scripts/unpack.py <office_file> <output_dir> - Bearbeiten Sie die XML-Dateien (hauptsächlich
ppt/slides/slide{N}.xmlund verwandte Dateien). - KRITISCH: Validieren Sie unmittelbar nach jeder Bearbeitung und beheben Sie alle Validierungsfehler, bevor Sie fortfahren:
python ooxml/scripts/validate.py <dir> --original <file> - Packen Sie die endgültige Präsentation:
python ooxml/scripts/pack.py <input_directory> <office_file>
Erstellen einer neuen PowerPoint-Präsentation mithilfe einer Vorlage
Wenn Sie eine Präsentation erstellen müssen, die dem Design einer vorhandenen Vorlage folgt, müssen Sie die Vorlagenfolien duplizieren und neu anordnen, bevor Sie Platzhalterinhalte ersetzen.
Workflow
-
Vorlagentext extrahieren UND visuelles Thumbnail-Raster erstellen:
- Text extrahieren:
python -m markitdown template.pptx > template-content.md template-content.mdlesen: Lesen Sie die gesamte Datei, um den Inhalt der Vorlagenpräsentation zu verstehen. Setzen Sie beim Lesen dieser Datei NIE Bereichsgrenzen.- Thumbnail-Raster erstellen:
python scripts/thumbnail.py template.pptx - Siehe Abschnitt Erstellen von Thumbnail-Rastern für weitere Details
- Text extrahieren:
-
Vorlage analysieren und Inventar in einer Datei speichern:
- Visuelle Analyse: Überprüfen Sie Thumbnail-Raster, um Folienlayouts, Designmuster und visuelle Struktur zu verstehen.
- Erstellen und speichern Sie eine Vorlageninventardatei unter
template-inventory.mdmit folgendem Inhalt:# Vorlageninventar-Analyse **Gesamtanzahl Folien: [Anzahl]** **WICHTIG: Folien sind 0-indexiert (erste Folie = 0, letzte Folie = Anzahl-1)** ## [Kategoriename] - Folie 0: [Layoutcode, falls verfügbar] – Beschreibung/Zweck - Folie 1: [Layoutcode] – Beschreibung/Zweck - Folie 2: [Layoutcode] – Beschreibung/Zweck [... JEDE Folie muss einzeln mit ihrem Index aufgeführt werden ...] - Verwendung des Thumbnail-Rasters: Verweisen Sie auf die visuellen Thumbnails, um Folgendes zu identifizieren:
- Layoutmuster (Titelfolien, Inhaltslayouts, Abschnittstrenner)
- Orte und Anzahl der Bildplatzhalter
- Designkonsistenz über Foliengruppen hinweg
- Visuelle Hierarchie und Struktur
- Diese Inventardatei ist ERFORDERLICH, um im nächsten Schritt geeignete Vorlagen auszuwählen.
-
Präsentationsgliederung basierend auf dem Vorlageninventar erstellen:
-
Überprüfen Sie die verfügbaren Vorlagen aus Schritt 2.
-
Wählen Sie eine Intro- oder Titelvorlage für die erste Folie. Dies sollte eine der ersten Vorlagen sein.
-
Wählen Sie für die anderen Folien sichere, textbasierte Layouts.
-
KRITISCH: Layoutstruktur an tatsächlichen Inhalt anpassen:
- Einspaltige Layouts: Für einheitliche Erzählung oder ein einzelnes Thema verwenden.
- Zweispaltige Layouts: NUR verwenden, wenn Sie genau 2 verschiedene Elemente/Konzepte haben.
- Dreispaltige Layouts: NUR verwenden, wenn Sie genau 3 verschiedene Elemente/Konzepte haben.
- Bild + Text Layouts: NUR verwenden, wenn Sie tatsächliche Bilder zum Einfügen haben.
- Zitatlayouts: NUR für tatsächliche Zitate von Personen (mit Quellenangabe) verwenden, niemals zur Hervorhebung.
- Verwenden Sie niemals Layouts mit mehr Platzhaltern, als Sie Inhalt haben.
- Wenn Sie 2 Elemente haben, zwingen Sie sie nicht in ein 3-spaltiges Layout.
- Wenn Sie 4+ Elemente haben, ziehen Sie in Betracht, sie auf mehrere Folien aufzuteilen oder ein Listenformat zu verwenden.
-
Zählen Sie Ihre tatsächlichen Inhaltselemente, BEVOR Sie das Layout auswählen.
-
Überprüfen Sie, ob jeder Platzhalter im gewählten Layout mit sinnvollen Inhalten gefüllt wird.
-
Wählen Sie eine Option aus, die das beste Layout für jeden Inhaltsabschnitt darstellt.
-
Speichern Sie
outline.mdmit Inhalt UND Vorlagenzuordnung, die die verfügbaren Designs nutzt. -
Beispiel für eine Vorlagenzuordnung:
-
… [für die Übersetzung gekürzt]