slide-studio

Slide Studio

PowerPointプレゼンテーションをXML直接編集で作成。

Step 1: 目的を確認

必ず最初にユーザーに確認する:

何をしたいですか？

1. 新規作成: 新しいプレゼンテーションを作成
2. テーマ適用: 既存のPPTXに新しいテーマ（POTX）を適用してデザインを変更
3. 編集: 既存のPPTXの内容を編集（テーマ変更なし）

テンプレートについて

プレゼンテーションのテンプレート（POTX）はお持ちですか？

持っている場合: テンプレートのテーマ、色、レイアウトを適用します 持っていない場合: クリエイティブなテンプレートを探すお手伝いをしましょうか？

クリエイティブなテンプレートが欲しい場合

以下のサイトで無料のPOTX/PPTXテンプレートを入手可能:

サイト	特徴
Slidesgo	モダン、多彩なスタイル、Google Slides/PPTX両対応
SlidesCarnival	ビジネス向け、シンプル、完全無料
ALLPPT	大量のテンプレート、業界別カテゴリ
Canva	デザイン性高い、PPTXエクスポート可能
Microsoft 365	公式、Office最適化

ユーザーへの提案例:

• 「どんな雰囲気のプレゼンを作りたいですか？（ビジネス/クリエイティブ/ミニマル/カラフル）」
• 「Slidesgoで『[キーワード] presentation template』で検索すると良いテンプレートが見つかります」
• 「テンプレートをダウンロードしたら、POTXまたはPPTXファイルを共有してください」

---

Step 2: ワークフロー選択

シナリオ	ワークフロー
テンプレートあり（新規作成）	テンプレート適用
テンプレートなし（新規作成）	ベースから作成
既存PPTXにテーマ適用	既存ファイルへのテーマ適用
既存ファイル編集（テーマ変更なし）	編集ワークフロー

---

テンプレート適用ワークフロー

# 1. ベース展開
node scripts/unpack.js assets/base.pptx ./work

# 2. テンプレート適用
node scripts/apply-potx.js ./work user-template.potx

# 3. レイアウト確認
node scripts/list-layouts.js ./work

# 4. スライド構築
node scripts/add-slide.js ./work --layout 2
node scripts/edit-text.js ./work --slide 2 --placeholder title --text "タイトル"

# 5. パック
node scripts/pack.js ./work output.pptx

---

ベースから作成ワークフロー

# 1. ベース展開
node scripts/unpack.js assets/base.pptx ./work

# 2. スライド構築
node scripts/add-slide.js ./work --layout 1  # タイトルスライド
node scripts/add-slide.js ./work --layout 2  # コンテンツスライド

# 3. テキスト編集
node scripts/edit-text.js ./work --slide 1 --placeholder ctrTitle --text "タイトル"

# 4. パック
node scripts/pack.js ./work output.pptx

---

既存ファイルへのテーマ適用ワークフロー

既存のPPTXファイルに新しいテーマ（POTX）を適用して、デザインを一新する。 スライドの内容は保持しつつ、色、フォント、背景、レイアウトスタイルが変更される。

# 1. 既存PPTXを展開
node scripts/unpack.js existing-presentation.pptx ./work

# 2. 現在の構造を確認
node scripts/list-slides.js ./work
node scripts/list-layouts.js ./work

# 3. テーマ（POTX）を適用
node scripts/apply-potx.js ./work new-theme.potx

# 4. 新しいレイアウトを確認
node scripts/list-layouts.js ./work

# 5. （オプション）内容の微調整
# テーマ変更後、レイアウトの調整が必要な場合
node scripts/edit-text.js ./work --slide 1 --placeholder title --text "調整後タイトル"

# 6. パック
node scripts/pack.js ./work themed-output.pptx

注意点

• レイアウトマッピング: テンプレートに同じ番号のレイアウトがあれば自動的にマッピングされる。存在しない場合はレイアウト1（タイトルスライド）にフォールバック
• 内容の保持: テキストや画像などのコンテンツは保持されるが、位置やスタイルはテーマに依存
• 確認推奨: 適用後は必ずPowerPoint/Google Slidesで開いて表示を確認する

PPTXをテンプレートとして使用

POTXファイルがなくても、PPTXファイルからテーマを抽出できる:

# PPTXファイルでも同じコマンドで適用可能
node scripts/apply-potx.js ./work design-source.pptx

---

編集ワークフロー

# 1. 展開
node scripts/unpack.js existing.pptx ./work

# 2. 構造確認
node scripts/list-slides.js ./work

# 3. 編集
node scripts/edit-text.js ./work --slide 1 --placeholder title --text "新タイトル"

# 4. パック
node scripts/pack.js ./work updated.pptx

---

スクリプト一覧

スクリプト	用途	使用例
unpack.js	PPTX展開	node scripts/unpack.js input.pptx ./work
pack.js	PPTX作成	node scripts/pack.js ./work output.pptx
apply-potx.js	テンプレート適用	node scripts/apply-potx.js ./work template.potx
add-slide.js	スライド追加	node scripts/add-slide.js ./work --layout 2
delete-slide.js	スライド削除	node scripts/delete-slide.js ./work --slide 3
clone-slide.js	スライド複製	node scripts/clone-slide.js ./work --source 1
edit-text.js	テキスト編集	node scripts/edit-text.js ./work --slide 1 --placeholder title --text "..."
add-image.js	画像追加	node scripts/add-image.js ./work --slide 1 --image logo.png
list-layouts.js	レイアウト一覧	node scripts/list-layouts.js ./work
list-slides.js	スライド一覧	node scripts/list-slides.js ./work
visualize-slide.js	ASCII構造表示	node scripts/visualize-slide.js ./work --slide 1
add-shape.js	シェイプ自由配置	node scripts/add-shape.js ./work --slide 1 --type textbox ...

---

レイアウト

#	名前	プレースホルダー
1	Title Slide	ctrTitle, subTitle
2	Title and Content	title, body
3	Section Header	title, body
4	Two Content	title, body×2
5	Comparison	title, body×4
6	Title Only	title
7	Blank	(なし)
8	Content with Caption	title, body×2
9	Picture with Caption	title, body, pic
10	Title and Vertical Text	title, body
11	Vertical Title and Text	title, body

---

カスタムレイアウト（自由配置）

標準レイアウトでは表現できない場合、add-shape.jsでシェイプを自由配置。

構造確認（ASCII可視化）

# スライドのシェイプ配置をASCIIアートで表示
node scripts/visualize-slide.js ./work --slide 1

出力例:

+----------------------------------------------------------------------+
|                                                                      |
|          +--------------------------+                                |
|          |            [1]           |                                |
|          +--------------------------+                                |
|                                                                      |
+----------------------------------------------------------------------+

Shapes:
[1] TextBox 4
    Position: (2.00", 3.00")  Size: 5.00" × 1.00"
    Text: "Custom Text..."

シェイプ追加

# テキストボックス追加（テーマ色対応）
node scripts/add-shape.js ./work --slide 1 --type textbox \
    --text "見出し" --x 2 --y 1 --width 5 --height 1 \
    --color accent1 --font-size 24 --bold

# 矩形追加
node scripts/add-shape.js ./work --slide 1 --type rect \
    --x 1 --y 5 --width 10 --height 0.5 --fill accent2

テーマ色

テンプレート適用後、以下のテーマ色が使用可能:

色名	用途
dk1, dk2	ダーク（テキスト向け）
lt1, lt2	ライト（背景向け）
accent1〜accent6	アクセントカラー
hlink, folHlink	ハイパーリンク

RGB直接指定も可能: --color FF0000

add-shape.js オプション

オプション	説明
--type	textbox または rect
--x, --y	位置（インチ）
--width, --height	サイズ（インチ）
--text	テキスト内容
--color	テキスト色（テーマ色 or RGB）
--fill	塗りつぶし色
--font-size	フォントサイズ（pt）
--bold, --italic	太字/斜体
--align	left, center, right

手動編集が必要な場合

複雑なシェイプや高度な書式は ./work/ppt/slides/slideN.xml を直接編集。 詳細は references/slide-patterns.md を参照。

---

確認方法

テキスト抽出

# markitdownでテキスト内容を確認（インストール済みの場合）
python -m markitdown output.pptx

構造確認

# スライド一覧
node scripts/list-slides.js ./work

# XMLを直接読む
# slideN.xmlの<p:sp>要素でシェイプ構造を確認

ユーザー確認

生成後、ユーザーにPowerPoint/Google Slidesで開いて確認してもらう。