pptx_mastery

Files (1)

• SKILL.md

SKILL.md (first lines)

# Professional Presentation Slide Deck Engineering with Python

This skill teaches how to generate stunning, executive-ready 16:9 widescreen PowerPoint slide decks (`.pptx`) using `python-pptx`, including inheriting from existing company master templates, embedding vector diagrams, generating high-DPI charts, and writing speaker notes.

---

## 🎨 Part 1: High-Level Presentation Architecture & Theming

A great presentation is visually restrained, highly structured, and avoids wall-of-text slides.

### 1. Presentation Canvas Standards
* **Aspect Ratio**: Always **16:9 Widescreen** (`13.333 × 7.5 inches` / `1920×1080 equivalent`). Never 4:3.
* **Color Palette (60-30-10 Rule)**:
  - **60% Dominant Canvas**: Clean background (Pure White `#FFFFFF` or Deep Night Slate `#0F172A`).
  - **30% Structural Neutral**: Cards, containers, table borders (Soft Gray `#F1F5F9` or Charcoal `#1E293B`).
  - **10% Accent Punch**: Brand primary for metric highlights, key badges, primary CTAs (e.g. Vibrant Indigo `#4F46E5` or Electric Blue `#0284C7`).

### 2. Core Slide Archetypes
1. **Title / Cover Slide**: Asymmetrical bold title, subtitle, presenter credentials, dark contrast background.
2. **Executive Summary / 3-Card Grid**: Three distinct horizontal or vertical cards summarizing the core pillars.
3. **Big Number / Metric Callout**: Oversized metric numbers (`54–72 pt`) with brief explanation labels below.
4. **Comparison / Architecture Split**: 2-column side-by-side card container layout comparing Old vs. New or Problem vs. Solution.
5. **Data Visualization Slide**: Clean chart on one half, 3 structured takeaways / bullet points on the other.

---

## 💻 Part 2: Starting from an Existing Workspace Template

The best way to preserve company branding, custom fonts, and pre-designed footers is to **clone an existing template file** rather than starting with a blank canvas.

```python
import shutil
from pathlib import Path
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor

def create_deck_from_template(template_name: str, output_name: str = "final_presentation.pptx"):
    ws_root = Path(".")
    template_path = ws_root / template_name

    # 1. Clone template to working output file
    if template_path.exists():
        output_path = ws_root / output_name
        shutil.copy2(template_path, output_path)
        prs = Presentation(str(output_path))
        print(f"✅ Cloned template '{template_name}' -> '{output_name}'")
    else:
        # Fallback to fresh 16:9 widescreen presentation
        prs = Presentation()
        prs.slide_width = Inches(13.333)
        prs.slide_height = Inches(7.5)
        output_path = ws_root / output_name
        print("ℹ️ Template not found; created clean 16:9 widescreen presentation.")

    return prs, output_path
```

---

## 💻 Part 3: Building a Complete 16:9 Executive Deck in Python

### Required Dependency
```bash
pip install python-pptx matplotlib
```

### Complete End-to-End Presentation Builder

```python
import io
import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt
from pathlib import Path
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.enum.shapes import MSO_SHAPE
from pptx.dml.color import RGBColor

# ── Color Palette Constants ──
COLOR_BG_DARK   = RGBColor(15, 23, 42)     # Slate 900
COLOR_BG_LIGHT  = RGBColor(248, 250, 252) # Slate 50
COLOR_CARD_BG   = RGBColor(255, 255, 255) # Pure White
COLOR_PRIMARY   = RGBColor(31, 78, 121)    # Deep Corporate Blue
COLOR_ACCENT    = RGBColor(79, 70, 229)    # Indigo 600
COLOR_TEXT_MAIN = RGBColor(30, 41, 59)     # Slate 800
COLOR_TEXT_MUT  = RGBColor(100, 116, 139)  # Slate 500

def add_header(slide, category: str, title: str):
    """Standardized top category kicker and slide title."""
    tb = slide.shapes.add_textbox(Inches(0.8), Inches(0.5), Inches(11.5), Inches(1.2))
    tf = tb.text_frame
    tf.word_wrap = True
    tf.margin_left = tf.margin_top = tf.margin_right = tf.margin_bottom = 0

    # Kicker / Category
    p_kicker = tf.paragraphs[0]
    p_kicker.space_after = Pt(2)
    r_kicker = p_kicker.add_run()
    r_kicker.text = category.upper()
    r_kicker.font.size = Pt(10)
    r_kicker.font.bold = True
    r_kicker.font.color.rgb = COLOR_ACCENT

    # Title
    p_title = tf.add_paragraph()
    r_title = p_title.add_run()
    r_title.text = title
    r_title.font.size = Pt(24)
    r_title.font.bold = True
    r_title.font.color.rgb = COLOR_PRIMARY

def add_speaker_notes(slide, notes_text: str):
    """Adds professional speaker notes to a slide."""
    notes_slide = slide.notes_slide
    tf = notes_slide.notes_text_frame
    tf.text = notes_text

From ParisNeo/lollms_client, Apache-2.0.

More from ParisNeo/lollms_client