エディトリアルPPTXデッキ
洗練されたエディトリアル・ミニマリストスタイルのスライドデッキを作成し、編集可能なPPTXとしてエクスポートします。最終成果物は .pptx のみです。HTMLスライドはビルドソースに過ぎず、PDFやHTMLビューアは生成しません。
仕組み
スライドは制約付きHTML(スライドごとに1ファイル)で作成し、その後 scripts/html2pptx.js が各DOM要素をネイティブのPowerPointオブジェクト(ダブルクリックで編集可能な実際のテキストボックス)に変換します。ボディサイズは 1280px × 720px = 960pt × 540pt に固定されています(LAYOUT_WIDE)。
ビルドワークフロー
以下のチェックリストをコピーして進捗を追跡してください:
- [ ] 1. プロジェクトのスキャフォールディング(shared/ assets/ slides/ output/)
- [ ] 2. ナラティブを計画 → 各スライドをテンプレートタイプにマッピング
- [ ] 3. テンプレートから slides/NN-name.html を作成(テキストのみ編集)
- [ ] 4. check_overflow を実行 → 1280x720 に合わないスライドを修正
- [ ] 5. PPTXのみエクスポート
- [ ] 6. ビルドソースをクリーンアップ(.pptx のみ保持)
1. スキャフォールディング。 作業プロジェクト内に shared/、assets/、slides/、output/ を作成します。このスキルから shared/tokens.css をプロジェクトの shared/ にコピーします。このスキルの assets/ から使用する写真のみをプロジェクトの assets/ にコピーします。依存関係を一度インストールします:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. 計画。 ソースコンテンツをスライドリストに変換します。すべてのスライドはテンプレートタイプのいずれかです。典型的なデッキの構成 = カバー → (仕切り → 1~3枚のコンテンツスライド)× セクション → クロージング。テキストは簡潔に保ちます。このスタイルは風通しの良いデザインです。
3. スライド作成。 templates/ から最も近いテンプレートを slides/NN-name.html にコピーし、テキストを置き換えます。規則:
<link rel="stylesheet" href="../shared/tokens.css">を維持します。- タイトルはセリフ体、その他はすべてサンセリフ体を使用します(トークンですでに設定済み)。
- アクセントカラーは赤色1色のみ。ダークパネル(
--ink-panel)は控えめに使用し、その唯一のアクセントとしてゴールド#C9A24Bを使用します。 - 写真は
<img>で配置します(CSSbackground-imageは不可)。写真ライブラリを参照してください。
4. 適合確認。 オーバーフローするスライドはPPTXでクリップされます:
node scripts/check_overflow.mjs --slides slides
OVERFLOW とフラグされたものを修正(テキストを短くするか位置を調整)し、すべてが 1280x720 と報告されるまで繰り返します。
5. PPTXのみエクスポート。
node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx
スライドはファイル名でソートされます(01-…、02-…)。PDF/HTMLエクスポートは実行しないでください。PPTXが唯一の成果物です。
6. クリーンアップ。 slides/ 内のHTMLと一時ファイルを削除し、output/DeckName.pptx のみを残します(反復作業のために再利用可能な shared/ + assets/ は残しても構いません)。
デザインシステム
shared/tokens.css で定義されています。新しい色を作成しないでください。
| トークン | HEX | 用途 |
|---|---|---|
--ink | #1A1A1A | タイトルおよび主要な本文 |
--soft | #555555 | 二次的な本文 |
--muted | #8C8C8C | ラベル、注釈、ページ番号 |
--red | #C8102E | 唯一のアクセント:バー、キッカー、キーワード、下線 |
--red-deep | #A00C24 | テーブル内の強調(ネガティブ) |
--red-pale | #FBE9EC | コネクタチップ(例:「→」の丸) |
--box | #F4F3F1 | ライトカード / ゼブラ行 |
--line | #E4E2DE | 極細の区切り線 |
--ink-panel | #1C1C1C | ダークコントラストパネル |
| gold | #C9A24B | ダークパネル上のみのアクセント |
| background | #FFFFFF | ページ背景 |
- タイポグラフィ: 見出し(
h*)やタイトルはGeorgiaセリフ体。それ以外はArial/Helveticaサンセリフ体。 - シグネチャ: タイトルの左側にある細い赤い縦棒、その上に小さな字間を空けた赤いキッカー、下部中央に小さなページ番号。
- ブランド変更: 他の企業に合わせるには、
tokens.cssの--red(およびオプションで--ink-panel/gold)を変更するだけで完了です。他は何も変える必要はありません。
写真ライブラリ
写真はこのスキルの assets/ にあります。ポートレート画像は右側約40%の仕切り/カバーパネルを埋めます(object-fit:cover)。ランドスケープ画像は全面カバーに適しています。
| ファイル | 向き | 最適な用途 |
|---|---|---|
sail.png | ポートレート 589×1024 | 仕切り / カバー右パネル(デフォルト) |
lighthouse-cliff.png | ポートレート 627×1024 | 仕切り / カバー右パネル |
staircase.png | 縦長 312×1024 | 落ち着いた/抽象的な仕切り帯 |
mast.png | 細長 208×1024 | 細い仕切り帯 |
hiker-clouds.png | 細長 225×1024 | 細い仕切り帯 |
lighthouse-sunset.png | ランドスケープ 1024×721 | 全面カバー / 上部バンド |
sailboat-deck.png | ランドスケープ 1024×721 | 全面カバー / 上部バンド |
写真を変更するには、<img src="../assets/….png"> を差し替えます。統一感を持たせるために、すべての仕切りで一貫した1枚の写真(または1つのモチーフ)を使用してください。ユーザーは自分の画像を assets/ に追加することもできます。
テンプレートカタログ
templates/ にあります(各ファイルはオーバーフローなしの完全な1280×720スライドです):
| ファイル | タイプ |
|---|---|
01-cover.html | 分割カバー:左にセリフタイトル、右にポートレート写真 |
02-divider.html | セクション仕切り:キッカー + セリフタイトル + 赤いバー、右にポートレート写真 |
03-three-column.html | キッカー/タイトル + コアライン + 3カラム + 結果ストリップ |
04-mapping.html | 2カラムの「相手のニーズ→私たちの提供」とコネクタチップ |
05-compare-table.html | 3カラム比較表、ゼブラ行 |
06-dark-contrast.html | 2パネル(ライト vs ダーク)+ セリフフッターライン |
07-pipeline.html | 番号付き横型ステップパイプライン + ダーク出力バー |
08-closing.html | クロージングピッチ:番号付きセリフ行 + 右にポートレート写真 |
ハード制約
以下のルールを破るとHTML→PPTX変換が失敗するか、レンダリングが崩れます。詳細と修正方法は reference.md を参照してください:
- テキストは
<p>/<h1>~<h6>の中にのみ配置(<div>内に裸のテキストを置かない)。 - CSSグラデーションは使用禁止。
background/border/box-shadowは<div>にのみ適用、テキストタグには使用しない。background-imageは使用禁止。<img>を使用する。- インラインタグ(
span/em/strong)にマージンを設定できない。 - ボディサイズは1280×720に固定。要素がはみ出してはならない。
