SuperAPI AI 工具集

python-pptx

办公与效率

查看项目

更新于 10-16 06:08

技能介绍

概述

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),指定表头、数据以及列宽。

(注:资料在表格创建部分的函数代码处截断,后续内容暂未提供。)