Slide Tools (pptxgenjs)

PowerPoint で再編集可能な .pptx を生成するツール群。

4 ツール:

SetTheme : テーマ (色・フォント・サイズ) を選ぶ。冒頭で 1 回
AddSlide : スライドを 1 枚追加する
BuildPptx : 蓄積した状態から .pptx を書き出す。最後に 1 回
ResetSlides : 全スライドを破棄する (テーマは維持)

中間状態は output/.slides.json に保存される。直接編集しないこと。

SetTheme

SetTheme({
  preset: "corporate-blue" | "minimal-mono" | "vibrant" | "academic" | "dark" | "warm-paper",
  overrides?: {
    primary?: string,     // "#1A5490" 等
    accent?: string,
    background?: string,
    text?: string,
    muted?: string,
    heading_font?: string,
    body_font?: string,
    title_size?: number,  // pt
    heading_size?: number,
    body_size?: number,
  }
})

preset 一覧:

preset	雰囲気
corporate-blue	営業・社内提案 (青基調)
minimal-mono	既定。シンプルな黒白
vibrant	ポップ、LT 向け (赤×ティール)
academic	学術発表 (落ち着いた青、セリフ)
dark	暗背景・明るいテキスト
warm-paper	クリーム背景、温かみ

AddSlide

AddSlide({
  layout: "title" | "section" | "bullets" | "two-column" |
          "image-right" | "image-left" | "image-full" |
          "table" | "chart" | "quote" | "closing" | "custom",
  content: { /* layout 依存 */ },
  notes?: string
})

layout ごとの content

title: { title, subtitle?, author?, date? } section: { number?: "01", title } bullets: { title, bullets: string[], footnote? } two-column: { title, left: {heading?, bullets?, text?}, right: {...} } image-right / image-left: { title, body: string | string[], image: { path, alt? } } image-full: { image: { path }, caption? } table: { title, headers: string[], rows: string[][], col_widths?: number[] }

col_widths は比率 (合計 1.0 で全幅、例 [0.3, 0.5, 0.2])。省略時は均等割 chart: { title, chart_type: "bar"|"line"|"pie"|"doughnut"|"area"|"scatter", data: { categories: string[], series: [{name, values: number[]}] } }
series[].values.length は categories.length と一致必須 quote: { quote, attribution? } closing: { message?: "Thank you", contact? } custom: { elements: Array<...> } (escape hatch、詳細下記)

custom.elements

座標単位は inch。安全領域は x=0.5, y=0.5, w=12.33, h=6.5。

{ type: "text",  text, x, y, w, h, options?: {font_size, bold, color, align} }
{ type: "image", path, x, y, w, h }
{ type: "shape", shape: "rect"|"roundRect"|"arrow"|"oval"|"line",
  x, y, w, h, options?: {fill, line, text} }
{ type: "table", headers, rows, x, y, w, h }
{ type: "chart", chart_type, data, x, y, w, h }

よくある失敗

画像パスは workspace 相対 (input/foo.png 等)。URL は不可 → 事前に DownloadFile
chart の series.values.length と categories.length の不一致は AddSlide 時点で reject
table.col_widths を指定するなら headers の長さと同じ要素数

BuildPptx

BuildPptx({ output?: string })   // 既定 "output/slides.pptx"

output は workspace 相対、output/ 配下のみ可
戻り値に「スライド数 / ファイルサイズ / テーマ / 警告」が含まれる
スライドが 0 枚なら error
.slides.json が壊れていれば error + ResetSlides() を提案

ResetSlides

ResetSlides()

slides[] を空にする
theme は維持
全枚やり直すときのみ使う

PDF が欲しい場合

このツールは PDF 出力に非対応。生成された .pptx を PowerPoint / Keynote / LibreOffice で開いて Export してもらう。

3.8 KiB Raw Blame History