---

name: pptx description: "Use this skill when you need to create, read, or modify PowerPoint presentations (.pptx), generate slides programmatically, or work with templates and layouts."

PPTX Creation, Editing, and Analysis

PowerPointプレゼンテーション（.pptx）の読み込み・生成・レイアウト調整。

依存ツール

• python-pptx: PowerPoint操作ライブラリ
• pandoc: PPTXからMarkdown変換
• LibreOffice: PPTX → PDF/画像変換
• Playwright/Sharp: HTMLからPPTX生成（高度な用途）

インストール

brew install pandoc
brew install --cask libreoffice
pip install python-pptx
npm install -g pptxgenjs  # オプション

基本操作

新規プレゼンテーション作成

from pptx import Presentation
from pptx.util import Inches, Pt

prs = Presentation()

# タイトルスライド
title_slide_layout = prs.slide_layouts[0]
slide = prs.slides.add_slide(title_slide_layout)
title = slide.shapes.title
subtitle = slide.placeholders[1]
title.text = "Presentation Title"
subtitle.text = "Subtitle"

# コンテンツスライド
bullet_slide_layout = prs.slide_layouts[1]
slide = prs.slides.add_slide(bullet_slide_layout)
shapes = slide.shapes
title_shape = shapes.title
body_shape = shapes.placeholders[1]

title_shape.text = "Slide Title"
tf = body_shape.text_frame
tf.text = "First bullet point"

# 追加の箇条書き
p = tf.add_paragraph()
p.text = "Second bullet point"
p.level = 1  # インデント

prs.save("presentation.pptx")

既存PPTXの読み込み

from pptx import Presentation

prs = Presentation("existing.pptx")

# 全スライドのテキスト
for i, slide in enumerate(prs.slides):
    print(f"--- Slide {i+1} ---")
    for shape in slide.shapes:
        if hasattr(shape, "text"):
            print(shape.text)

画像追加

from pptx import Presentation
from pptx.util import Inches

prs = Presentation()
blank_slide_layout = prs.slide_layouts[6]
slide = prs.slides.add_slide(blank_slide_layout)

# 画像配置
left = Inches(1)
top = Inches(1)
width = Inches(5)
slide.shapes.add_picture("image.png", left, top, width=width)

prs.save("with_image.pptx")

表の追加

from pptx import Presentation
from pptx.util import Inches

prs = Presentation()
blank_slide_layout = prs.slide_layouts[6]
slide = prs.slides.add_slide(blank_slide_layout)

# 表追加（2行3列）
rows, cols = 2, 3
left = Inches(1)
top = Inches(2)
width = Inches(8)
height = Inches(2)

table = slide.shapes.add_table(rows, cols, left, top, width, height).table

# ヘッダー
table.cell(0, 0).text = "Column 1"
table.cell(0, 1).text = "Column 2"
table.cell(0, 2).text = "Column 3"

# データ
table.cell(1, 0).text = "Value 1"
table.cell(1, 1).text = "Value 2"
table.cell(1, 2).text = "Value 3"

prs.save("with_table.pptx")

グラフ追加

from pptx import Presentation
from pptx.chart.data import CategoryChartData
from pptx.enum.chart import XL_CHART_TYPE
from pptx.util import Inches

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])

# グラフデータ
chart_data = CategoryChartData()
chart_data.categories = ["Q1", "Q2", "Q3", "Q4"]
chart_data.add_series("Series 1", (10, 20, 30, 40))

# グラフ追加
x, y, cx, cy = Inches(2), Inches(2), Inches(6), Inches(4)
chart = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED, x, y, cx, cy, chart_data
).chart

chart.has_legend = True
chart.chart_title.text_frame.text = "Sales by Quarter"

prs.save("with_chart.pptx")

高度な操作

スライドマスター・レイアウト確認

from pptx import Presentation

prs = Presentation("template.pptx")

# 使用可能なレイアウト
for i, layout in enumerate(prs.slide_layouts):
    print(f"Layout {i}: {layout.name}")

テキストのスタイル設定

from pptx import Presentation
from pptx.util import Pt
from pptx.dml.color import RGBColor

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
txBox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(5), Inches(1))
tf = txBox.text_frame

p = tf.add_paragraph()
p.text = "Styled Text"
p.font.size = Pt(24)
p.font.bold = True
p.font.color.rgb = RGBColor(255, 0, 0)

prs.save("styled_text.pptx")

PPTXをPDFに変換

libreoffice --headless --convert-to pdf presentation.pptx --outdir .

PPTXをサムネイル画像に変換

# PPTX → PDF → 画像
libreoffice --headless --convert-to pdf presentation.pptx --outdir .
pdftoppm -jpeg -r 150 presentation.pdf slides
# → slides-1.jpg, slides-2.jpg, ...

PPTXからテキスト抽出

pandoc presentation.pptx -o output.txt

スライドの複製

from pptx import Presentation
import copy

prs = Presentation("input.pptx")

# 最初のスライドを複製
slide_to_copy = prs.slides[0]

# 新しいスライドとして追加
# 注: python-pptxにはslide複製の直接的なメソッドがないため、
# xml操作が必要（複雑）。LibreOfficeやVBAを推奨

スライドの並び替え

from pptx import Presentation

prs = Presentation("input.pptx")

# スライドの順序変更（0番目と1番目を入れ替え）
slides = list(prs.slides._sldIdLst)
slides[0], slides[1] = slides[1], slides[0]

prs.save("reordered.pptx")

デザインのベストプラクティス

カラーパレット

推奨カラーパレット例:

• プロフェッショナル: ネイビー (#1A237E) + ゴールド (#FBC02D)
• モダン: ブラック (#000000) + オレンジ (#FF5722)
• ナチュラル: グリーン (#4CAF50) + ベージュ (#D7CCC8)

フォント

• タイトル: 32-44pt、太字
• 本文: 18-24pt、標準
• 注釈: 12-16pt

レイアウト

• 1スライド1メッセージ
• 余白を十分に確保
• 画像は高解像度（最低150dpi）

トラブルシューティング

日本語フォントが反映されない

→ システムフォントを確認、run.font.nameに正確なフォント名

画像が圧縮される

→ PowerPoint設定で画像圧縮を無効化

グラフが表示されない

→ python-pptxのバージョン確認、chart_dataの形式確認

スライドマスターが適用されない

→ prs.slide_layouts[X]で適切なレイアウトを選択

参考

• python-pptx: https://python-pptx.readthedocs.io/
• pptxgenjs: https://gitbrent.github.io/PptxGenJS/
• LibreOffice CLI: https://help.libreoffice.org/