- name
- create-pptx
- description
- >
Create PowerPoint (python-pptx)
Setup
pip install python-pptx # or: uv pip install python-pptxOutput scripts to a logical location (e.g., 前端开发/demo/ or project folder), then run with python3 <script.py> and open the result.
Core helpers
Read and import scripts/pptx_helpers.py for ready-made drawing primitives: background, horizontal/vertical lines, textboxes, ovals, diagonal connectors, and fade transitions. Copy or import as needed.
Key units: EMU (English Metric Units). 1 pt = 12700 EMU, 1 cm ≈ 360000 EMU. Standard 16:9 slide = 12192000 × 6858000 EMU.
Workflow
- Understand the content — milestones, categories, colors, # slides
- Plan layout — compute X/Y positions in EMU up front; avoid magic numbers
- Build shapes — use helpers or
slide.shapes.add_shape/add_textbox - Add transitions — always call
add_fade_transition(slide)from helpers - Run and open —
python3 script.py && open output.pptx
Multi-slide instead of click animations (WPS-safe default)
WPS does not reliably support click-triggered PowerPoint animations. Always use multiple slides to reveal content progressively:
Slide 1 → skeleton / structure only
Slide 2 → skeleton + first data layer
Slide 3 → skeleton + all data layersAdd a fade transition (add_fade_transition) to each slide for smooth switching.
If the user explicitly asks for animations AND they are using Microsoft PowerPoint (not WPS), you may attempt XML-based animations — but read references/wps-compat.md first for the XML structure and known pitfalls.
Common patterns
Colors & theme
Define all colors as RGBColor constants at the top. Dark backgrounds look premium — use near-black (0x06, 0x0D, 0x1E) with bright accents.
Timeline layout
TL_L, TL_R = 850000, 11950000 # left/right margins (EMU)
TL_W = TL_R - TL_L
M_STEP = TL_W // 11 # 12 months → 11 intervals
def month_x(m): # 1-based month → EMU x-position
return TL_L + M_STEP * (m - 1)Collision resolution
When multiple cards share the same or nearby X position, spread them:
def resolve_collisions(events, card_w, gap):
events.sort(key=lambda e: e['cx'])
need = card_w + gap
for _ in range(120):
moved = False
for i in range(len(events) - 1):
a, b = events[i], events[i+1]
if b['cx'] - a['cx'] < need:
push = (need - (b['cx'] - a['cx'])) / 2
a['cx'] -= push; b['cx'] += push; moved = True
if not moved:
breakShape IDs for animation
python-pptx assigns shape IDs automatically. To retrieve them after creation:
shp = slide.shapes.add_shape(...)
shape_id = shp.shape_id # use this in animation XMLFor connectors added via raw XML, read back the max existing ID first:
def _max_existing_id(slide):
return max((int(el.get('id')) for el in slide.element.iter()
if el.get('id') and el.get('id').isdigit()), default=1)Template assets
Ready-to-use .pptx base files in assets/. Use them as the starting Presentation() object to inherit their design/theme:
from pptx import Presentation
prs = Presentation('/Users/scott/.cursor/skills/create-pptx/assets/business-dark.pptx')| File | Style | Source |
|---|---|---|
assets/business-dark.pptx | 深色商务 · Pitch Deck 风格 · 60 slides | Slidesgo "Product Vision Pitch Deck" (Attribution required) |
assets/education.pptx | 明亮教育 · 笔记本课程风格 · 多 slides | Slidesgo "Notebook Lesson XL" (Attribution required) |
Attribution: Free Slidesgo templates require keeping the attribution slide. When using these files, do NOT delete the last "Credits" slide.
Reference files
Read the relevant file based on the task:
references/pptx-patterns.md— EMU 单位速查、预设形状 ID、连接器 XML、
过渡 XML、多段落文字框、典型脚本结构
references/charts.md— python-pptx 原生图表 API：柱状、折线、饼图、散点、
多系列、样式设置（当用户需要数据图表时读此文件）
references/standard-slides.md— 标准商务幻灯片函数库：标题页、目录页、
要点页、图文并排、数据页、章节分隔页、结尾页（当用户需要完整 PPT 结构时读此文件）
references/wps-compat.md— WPS 动画兼容性踩坑记录（当用户提到 WPS 或
动画效果异常时读此文件）