TRAE ウェブ PPT 制作フロー
大学、企業などのPPTテンプレートを、編集可能で拡大縮小可能、高解像度でエクスポート可能なHTMLスライドに変換します。「マスター制約 + ページごとのレイアウト + スクリーンショットによる品質検証 + ヘッドレスブラウザによるエクスポート」によって完全なクローズドループを形成します。
適用シーン
- PPTテンプレート、参照スクリーンショット、既存のHTMLマスタースライドに基づいたWeb PPTの作成。
- スライドセット全体のバナー、ロゴ、カラー、フォント、グリッドの統一。
- TRAEを使用してのページごとの生成、編集、オーバーラップの修正、テキストの調整。
- HTMLスライドの高解像度PNGへの一括エクスポート(7680×4320の8K画像を含む)。
ユーザーがオブジェクトレベルで編集可能な .pptx を要求している場合は、PPTXツールを使用してください。HTML画像を編集可能なPowerPointとして誤って扱わないでください。
開始前の確認
ユーザーが既に持っている資料を優先して読み込み、ワークスペースに既にある情報を繰り返し要求しないでください。
- テンプレートの根拠:PPT、参照画像、HTMLマスターページ、またはブランドガイドライン。
- ページ内容:アウトライン、各ページのタイトル、要点、データ、画像、参考文献。
- 固定仕様:ページ比率、メインカラー、フォント、ロゴ、ヘッダー/フッター、および保持必須の要素。
- 納品形式:HTMLソースファイル、ローカル素材、プレビュー画像、8K画像、またはエクスポートエントリ。
非クリティカルな情報が不足している場合は、合理的なデフォルト値(16:9、システムフォント、ローカル素材、1920×1080の品質検証)を使用します。制作を妨げる内容が不足している場合にのみ質問してください。
コア原則
- 最初にマスターを分解し、その後でページを作成する:生成しながらスタイルを推測しない。
- マスター要素は不変:バナー、ロゴ、メインカラー、タイトル位置、コンテンツエリアのグリッドはページ間で移動しない。
- レイアウトサイズは相対化:配置、幅、高さ、フォントサイズ、間隔には
cqw/cqhを使用し、レイアウト制御に固定pxを混在させない。 - 1ページに1つの主要な表現構造:隣接するページで「左画像、右テキスト」を無意味に繰り返さない。ただし、比較ページなどの特別な場合を除く。
- 素材はローカライズ:一時的な画像ホスティングに依存しない。実際の写真は出典が明確である必要があり、概念図はインラインSVGを優先。
- 各ページのスクリーンショットで検収:コードにエラーがなくても画面が正しいとは限らないため、レンダリング結果を確認する必要がある。
- 修正範囲は最小限:単一ページの問題を修正する際に、他のモジュールを無作為に再配置したり、マスター全体を変更したりしない。
標準ワークフロー
ステップ1:テンプレートの分解と不変要素の確立
参照テンプレートから以下を抽出して記録します:
| カテゴリ | 確認が必要な内容 |
|---|---|
| バナー | 背景、ロゴ位置、タイトル位置、装飾線、固定高さ |
| カラー | メインカラー、補助カラー、本文カラー、グレースケール、アクセントカラーの使用ルール |
| フォント | タイトルフォント、本文フォント、フォントサイズ階層、フォントウェイト |
| グリッド | 左右のマージン、コンテンツエリアの開始位置、カラム間の間隔、フッター位置 |
| 可変項目 | 各ページのタイトル、サブタイトル、本文構成、画像とグラフ |
システムフォントを優先的に使用し、外部フォントが異なるコンピューターで機能しなくなるのを防ぎます。参照画像を再現する必要がある場合は、「位置、サイズ、フォント、配色を参照と一致させる」ことをハード制約として記述し、「スタイルが類似している」といった表現は避けてください。
ステップ2:16:9の技術基盤の構築
すべてのページで同じコンテナロジックを共有します:
/* スライドコンテナ:16:9を維持し、コンテナクエリサイズ単位を有効にする。 */
.slide {
width: min(100vw, calc(100vh * 16 / 9));
aspect-ratio: 16 / 9;
position: relative;
overflow: hidden;
container-type: size;
}
/* ページ要素:コンテナに対して相対的に配置され、ウィンドウサイズ変更時に比率を維持する。 */
.title {
position: absolute;
top: 6.5cqh;
left: 4cqw;
font-size: 2.5cqw;
}
container-type: size は cqw/cqh を機能させるための鍵です。1920×1080のキャンバスでは、1cqw = 19.2px、1cqh = 10.8px です。ウィンドウを縮小したり、プロジェクターで拡大したり、高倍率でエクスポートしたりする場合でも、レイアウト比率は一貫しています。
ステップ3:マスターページの作成
最初に少数のベースページを作成し、その後で残りのページを一括生成します:
- 表紙ページ:メインタイトル、発表者、所属、日付、およびブランドビジュアル。
- 本文マスターページ:固定バナー、タイトルエリア、コンテンツグリッド、フッター。
- 最終ページ:結論、謝辞、または参考文献。内容に応じて用途を区別します。
マスターページが検収されたら、それを後続のページの構造とスタイルの基準として使用します。既存のページを変更する前に、必ずファイルを読み込んでください。ファイル名から構造を推測しないでください。
ステップ4:ページごとの生成とコンテンツ構造へのマッチング
新しいページを生成するたびに、以下の5項目を明確に記述します:
- どのマスターページを参照し、どの要素を変更しないか。
- ページ比率、ファイル名、保存場所。
- このページのタイトル、要点、データ、結論。
- このページで採用するレイアウト、および前のページとの違い。
- 画像の出典、ローカライズ要件、著作権に関する制約。
コンテンツに応じてレイアウトを選択できます。新規性のために情報表現を犠牲にしないでください:
| コンテンツタイプ | 推奨構造 |
|---|---|
| 表紙 | 中央大見出し、ブランドバナー、単一メインビジュアル |
| 並列オブジェクト | 等幅カード配列、カラム比較 |
| フローとフェーズ | 階段、タイムライン、段階的バナー |
| 因果関係 | チェーン、矢印フロー、中心放射 |
| コアコンセプト | 中心図解 + 周囲注釈 |
| 構造と原理 | 断面図、SVG模式図 + 要点 |
| データとダッシュボード | グラフ、指標カード、見開きパネル |
| 多次元情報 | 2×2グリッド、マトリックス、グループカード |
| 結論 | 中心論点、縦軸収束、少数のキーナンバー |
| 参考文献 | 文献表紙または出典スクリーンショット + 整形式リスト |
| 謝辞 | 大文字の短いテキスト + メインビジュアル、モジュールの積み重ねを削減 |
ステップ5:画像の選択方法
以下の優先順位で選択します:
- 実際の写真:ユーザーが提供した、またはライセンスが明確な素材を優先。公開素材は許諾を確認し、出典を記録する。
- インラインSVG:結晶構造、欠陥、断面図、フロー、因果関係など、直接撮影できない概念に適している。
- CSSグラフィック:階段、スペクトルバー、バッジ、インジケーター背景色など、シンプルな装飾情報グラフィックに適している。
すべての画像はローカルに保存し、参照パスを確認してください。コンテンツに関係のないAI生成の雰囲気画像をレイアウトを埋めるために使用しないでください。
ステップ6:ページごとのビジュアル品質検証
Windowsでは、Edgeのヘッドレスモードを呼び出して1920×1080の品質検証画像を生成できます。実際のブラウザパスとファイルパスに応じて調整します:
$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
--virtual-time-budget=6000 --window-size=1920,1080 `
--screenshot="_chk.png" "file:///absolute/path/to/page.html"
ページごとに確認:
- ページが16:9で完全に表示され、意図しないスクロールバーがない。
- 要素のオーバーフロー、クリッピング、オーバーラップ、モジュール間の間隔が狭すぎる箇所がない。
- すべての画像が正常に読み込まれ、空のプレースホルダーや破損画像がない。
- タイトル、本文、図のキャプションの階層が明確で、孤立した文字や異常な改行がない。
- バナー、ロゴ、カラー、グリッドがマスターページと一致している。
- データ、単位、年号、用語、参考文献の表記が一貫している。
- ウィンドウを縮小しても比率が維持され、固定ピクセル要素がレイアウトを壊していない。
問題を発見したら、まず根本原因を特定し、関連するスタイルまたは要素のみを修正し、再度スクリーンショットで確認します。角マーク、ヘッダーなどの要素を削除する際は、対応するHTML、CSS、ページタイトルも同時に確認し、残骸が残らないようにします。
ステップ7:高解像度画像のエクスポート
1920×1080のビューポートと4倍のデバイススケールを使用して、7680×4320のPNGをエクスポートします:
& $edge --headless=new --disable-gpu --hide-scrollbars `
--virtual-time-budget=6000 --window-size=1920,1080 `
--force-device-scale-factor=4 `
--screenshot="export/page.png" "file:///absolute/path/to/page.html"
この方法により、ブラウザはテキスト、CSS、SVGを高倍率で再レンダリングします。低解像度のビットマップを8Kに引き伸ばすわけではありません。
一括エクスポート時は、プロジェクトに既存のスクリプトを優先的に再利用します。プロセスが終了した後も、ファイルが存在し、サイズが正しく、ディスクに書き込まれていることを確認する必要があります。コマンドの終了コードだけで成功を判断しないでください。
ステップ8:成果物の整理
明確で再利用可能なディレクトリ構造を推奨します:
project/
├── 001.html ... NNN.html
├── assets/
│ ├── images/
│ └── logos/
├── export/
└── html2img_8k.py # プロジェクトに既存の場合、またはユーザーが要求した場合に提供
納品時には、ソースファイル、素材ディレクトリ、エクスポートディレクトリ、およびユーザーがまだ補充していない情報をリストアップします。一時的な品質検証スクリーンショットを正式な成果物に混在させないでください。
再利用可能なプロンプト
新しいページの生成
【マスターページパス】に基づいて、【新しいページファイル名】を生成してください:
1. 16:9、バナー、ロゴ、フォント、カラー、グリッドは変更しない;
2. タイトルは【タイトル】、内容は【要点A】【要点B】【要点C】を含む;
3. 【指定レイアウト】を採用し、隣接ページとは構造を変える;
4. ページ内の配置、サイズ、フォントサイズ、間隔にはcqw/cqhを使用する;
5. 画像はローカライズし、出典を明記する。完了後、1920×1080のスクリーンショットで品質検証を行う。
ビジュアル問題の修正
【ページパス】内の【特定モジュール】で発生している【オーバーラップ/オーバーフロー/画像破損/改行】の根本原因を特定し、
関連する問題のみを修正し、他のモジュールとマスターページは変更しないでください。修正後、再度スクリーンショットで検証してください。
テキストの調整
【ページパス】内の【原文】を【新しいテキスト】に置き換えてください。
既存のレイアウトを維持し、1行表示、孤立文字、オーバーフロー、モジュール間隔を確認してください。
よくある問題
| 問題 | 優先的に確認すること |
|---|---|
cqw/cqh が機能しない | コンテナに container-type: size が設定されているか、要素がそのコンテナ内にあるか |
| 別のPCでフォントが変わる | 外部フォントや未インストールのフォントを使用していないか、システムフォントスタックに変更 |
| 画像が空白または404 | ファイル名、大文字小文字、相対パス、特殊文字、ゼロ幅スペース |
| ファイル名にゼロ幅スペース U+200B が含まれる | ファイル名を変更するか、文字を %E2%80%8B にURLエンコード |
| モジュールがタイトルエリアに侵入 | コンテンツエリアの開始位置、モジュールの高さ、階段状の上昇量が大きすぎないか |
| 段落に孤立文字が出現 | まずテキストを最適化し、次にフォントサイズまたはコンテナ幅を微調整 |
| ページスタイルが徐々にずれる | マスターページを無視して自由に作成していないか、不変要素を再確認 |
| 8K画像がぼやける | 既存のスクリーンショットを拡大するのではなく、4倍のデバイススケールで再レンダリングしているか |
| エクスポートファイルが不完全 | ページのレンダリングとファイルのディスク書き込みが完了するのを待っているか |
完了基準
以下の条件がすべて満たされた場合にのみ完了とみなされます:
- マスターページと全ページのスタイルが一貫しており、コンテンツページの構造が情報表現に役立っている。
- 新規追加または変更されたすべてのページが、実際のレンダリングチェックを経ている。
- 画像、フォント、ロゴ、スクリプトの参照が利用可能であり、素材はローカライズされている。
- エクスポートされた画像のサイズが要件を満たしており、8K出力は7680×4320である。
- 納品ディレクトリが明確であり、一時ファイルと正式な成果物が分離されている。