概述
python-pptx 是一个用于创建和更新 PowerPoint(.pptx)演示文稿的 Python 库。本技能涵盖演示文稿自动化的完整模式,包括:
- 使用多种幻灯片版式创建演示文稿
- 形状操作,包括文本框、图片和几何图形
- 在幻灯片内生成用于数据可视化的图表
- 创建用于结构化数据展示的表格
- 自定义母版幻灯片以保持品牌一致性
- 基于模板的生成,以获得一致的演示文稿
- 占位符管理,用于动态内容插入
适用场景
使用本技能的时机:
- 从数据自动生成演示文稿
- 创建标准化的报告演示文稿
- 构建具有一致品牌的幻灯片组
- 自动化仪表盘演示
- 从模板创建培训材料
- 从数据库生成客户演示文稿
- 为定期报告构建演示文稿流水线
- 根据数据创建包含图表和表格的幻灯片
- 批量生成内容可变的演示文稿
不适用场景:
- 需要实时编辑演示文稿(请使用 PowerPoint)
- 创建含复杂动画的演示文稿
- 需要高级切换效果(支持有限)
- 需要带播放控制的嵌入式视频
- 需要保留复杂的 PowerPoint 功能
- 不使用 Python 从零创建演示文稿(请使用 PowerPoint)
前置条件与安装
基本安装:
pip install python-pptx
使用 uv(推荐):
uv pip install python-pptx
带图片支持:
pip install python-pptx Pillow
图表功能完整安装:
pip install python-pptx Pillow lxml
验证安装:
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.shapes import MSO_SHAPE
from pptx.enum.text import PP_ALIGN
print("python-pptx installed successfully!")
核心能力
1. 基础演示文稿创建
可创建包含常见幻灯片类型的演示文稿,设置幻灯片尺寸(如 16:9 宽屏,13.333 x 7.5 英寸),添加标题幻灯片、标题加内容幻灯片、双内容幻灯片、节标题幻灯片以及空白幻灯片,并在空白幻灯片上添加自定义文本框和几何形状(矩形、圆角矩形、椭圆等),设置填充颜色与文本。
2. 高级文本格式化
支持通过 runs(文本段)实现同一段落内不同字体样式,包括字号、加粗、颜色、斜体。支持段落对齐、段后间距、行距、段前间距设置,支持下标与上标(通过设置 baseline 属性),以及带自定义格式的项目符号列表(如指标、数值、变化量的分段着色展示)。
3. 图表生成
支持在幻灯片中生成多种图表类型,包括簇状柱形图、带标记的折线图、饼图、簇状条形图(水平)、堆积柱形图、圆环图。可自定义图例及其位置、数据标签、数字格式(如 $#,##0)、百分比显示等。
4. 表格创建
支持创建并格式化表格幻灯片,设置单元格背景颜色(通过十六进制颜色转换为 RgbColor),指定表头、数据以及列宽。
(注:资料在表格创建部分的函数代码处截断,后续内容暂未提供。)