# PPTXの作成、編集、分析 ## 概要ユーザーは.pptxファイルの作成、編集、または内容の分析を依頼する場合があります。.pptxファイルは本質的にXMLファイルとその他のリソースを含むZIPアーカイブであり、読み取りや編集が可能です。タスクに応じて異なるツールとワークフローが利用可能です。 ## コンテンツの読み取りと分析 ### テキスト抽出プレゼンテーションのテキスト内容を読み取るだけの場合は、ドキュメントをmarkdownに変換します： # ドキュメントをmarkdownに変換 python -m markitdown path-to-file.pptx ### Raw XMLアクセスコメント、発表者ノート、スライドレイアウト、アニメーション、デザイン要素、複雑な書式設定にはRaw XMLアクセスが必要です。これらの機能には、プレゼンテーションを展開してRaw XMLコンテンツを読み取る必要があります。 #### ファイルの展開 `python ooxml/scripts/unpack.py ` **注意** : unpack.pyスクリプトはプロジェクトルートからの相対パスで`skills/pptx/ooxml/scripts/unpack.py`にあります。このパスにスクリプトが存在しない場合は、`find . -name "unpack.py"`を使用して検索してください。 #### 主要なファイル構造 * `ppt/presentation.xml` \- メインプレゼンテーションメタデータとスライド参照 * `ppt/slides/slide{N}.xml` \- 個々のスライドコンテンツ（slide1.xml, slide2.xmlなど） * `ppt/notesSlides/notesSlide{N}.xml` \- 各スライドの発表者ノート * `ppt/comments/modernComment_*.xml` \- 特定のスライドへのコメント * `ppt/slideLayouts/` \- スライドのレイアウトテンプレート * `ppt/slideMasters/` \- マスタースライドテンプレート * `ppt/theme/` \- テーマとスタイル情報 * `ppt/media/` \- 画像とその他のメディアファイル #### タイポグラフィと色の抽出 **模倣するデザイン例がある場合** : 以下の方法を使用して、まずプレゼンテーションのタイポグラフィと色を分析します： 1. **テーマファイルを読む** : `ppt/theme/theme1.xml`で色（``）とフォント（``）を確認 2. **スライドコンテンツをサンプリング** : `ppt/slides/slide1.xml`で実際のフォント使用（``）と色を調べる 3. **パターンを検索** : grepを使用してすべてのXMLファイルで色（``、``）とフォント参照を検索 ## テンプレートなしで新規PowerPointプレゼンテーションを作成新規PowerPointプレゼンテーションをゼロから作成する場合は、**html2pptx** ワークフローを使用してHTMLスライドを正確な位置指定でPowerPointに変換します。 ### デザイン原則 **重要** : プレゼンテーションを作成する前に、コンテンツを分析して適切なデザイン要素を選択してください： 1. **題材を考慮** : このプレゼンテーションは何についてですか？どのようなトーン、業界、または雰囲気を示唆していますか？ 2. **ブランディングを確認** : ユーザーが会社/組織に言及している場合、そのブランドカラーとアイデンティティを考慮 3. **パレットをコンテンツに合わせる** : 題材を反映する色を選択 4. **アプローチを説明** : コードを書く前にデザインの選択を説明 **要件** : * ✅ コードを書く前にコンテンツに基づいたデザインアプローチを説明 * ✅ Webセーフフォントのみ使用: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact * ✅ サイズ、太さ、色で明確な視覚的階層を作成 * ✅ 読みやすさを確保: 強いコントラスト、適切なサイズのテキスト、クリーンな配置 * ✅ 一貫性を保つ: スライド全体でパターン、間隔、視覚言語を繰り返す #### カラーパレットの選択 **創造的に色を選ぶ** : * **デフォルトを超えて考える** : この特定のトピックに本当に合う色は何ですか？自動的な選択を避ける * **複数の角度を考慮** : トピック、業界、雰囲気、エネルギーレベル、対象者、ブランドアイデンティティ（言及されている場合） * **冒険的に** : 予想外の組み合わせを試す - ヘルスケアのプレゼンテーションが緑である必要はなく、金融が紺色である必要もない * **パレットを構築** : 一緒に機能する3-5色を選ぶ（主要色 + サポート色 + アクセント） * **コントラストを確保** : テキストは背景上で明確に読める必要がある **カラーパレット例** （創造性を刺激するために使用 - 1つを選ぶか、適応するか、独自に作成）： 1. **クラシックブルー** : ディープネイビー(#1C2833)、スレートグレー(#2E4053)、シルバー(#AAB7B8)、オフホワイト(#F4F6F6) 2. **ティール＆コーラル** : ティール(#5EA8A7)、ディープティール(#277884)、コーラル(#FE4447)、白(#FFFFFF) 3. **ボールドレッド** : レッド(#C0392B)、ブライトレッド(#E74C3C)、オレンジ(#F39C12)、イエロー(#F1C40F)、グリーン(#2ECC71) 4. **ウォームブラッシュ** : モーブ(#A49393)、ブラッシュ(#EED6D3)、ローズ(#E8B4B8)、クリーム(#FAF7F2) 5. **バーガンディラグジュアリー** : バーガンディ(#5D1D2E)、クリムゾン(#951233)、ラスト(#C15937)、ゴールド(#997929) #### ビジュアルディテールオプション **ジオメトリックパターン** : * 水平ではなく斜めのセクション区切り * 非対称な列幅（30/70, 40/60, 25/75） * 90°または270°で回転したテキストヘッダー * 画像用の円形/六角形フレーム * コーナーの三角形アクセントシェイプ * 奥行きのための重なるシェイプ **ボーダー＆フレーム処理** : * 片側のみの太い単色ボーダー（10-20pt） * コントラストのある色の二重線ボーダー * フルフレームの代わりにコーナーブラケット * L字型ボーダー（上+左または下+右） * ヘッダー下のアンダーラインアクセント（3-5pt太さ） **タイポグラフィ処理** : * 極端なサイズコントラスト（72ptヘッドライン vs 11pt本文） * ワイドレタースペースの全大文字ヘッダー * オーバーサイズ表示タイプの番号付きセクション * データ/統計/技術コンテンツ用のモノスペース（Courier New） * 密な情報用のコンデンスドフォント（Arial Narrow） * 強調用のアウトラインテキスト ### レイアウトのヒント **チャートやテーブルを含むスライドを作成する場合:** * **2列レイアウト（推奨）** : 全幅にわたるヘッダーを使用し、その下に2列を配置 - 一方にテキスト/箇条書き、もう一方に注目コンテンツ。これによりバランスが良くなり、チャート/テーブルが読みやすくなる。各コンテンツタイプ用にスペースを最適化するため、不等列幅（例: 40%/60%分割）のフレックスボックスを使用 * **フルスライドレイアウト** : 注目コンテンツ（チャート/テーブル）をスライド全体に表示して最大のインパクトと読みやすさを実現 * **縦に積み重ねない** : チャート/テーブルをテキストの下に単一列で配置しない - これは読みやすさとレイアウトの問題を引き起こす ### ワークフロー 1. **必須 - ファイル全体を読む** : [`html2pptx.md`]()を最初から最後まで完全に読んでください。**このファイルを読む際に範囲制限を設定しないでください。** プレゼンテーション作成を進める前に、詳細な構文、重要な書式設定ルール、ベストプラクティスのためにファイル全体を読んでください。 2. 適切なサイズ（16:9の場合は720pt × 405ptなど）で各スライド用のHTMLファイルを作成 * すべてのテキストコンテンツに`

`, `

`-`

`, `
`, `
`を使用 * チャート/テーブルを追加する領域に`class="placeholder"`を使用（視認性のためにグレー背景でレンダリング） * 重要 : まずSharpを使用してグラデーションとアイコンをPNG画像にラスタライズし、その後HTMLで参照 * レイアウト : チャート/テーブル/画像を含むスライドには、より良い読みやすさのためにフルスライドレイアウトまたは2列レイアウトを使用 3. [`html2pptx.js`]()ライブラリを使用してHTMLスライドをPowerPointに変換し、プレゼンテーションを保存するJavaScriptファイルを作成・実行 * `html2pptx()`関数を使用して各HTMLファイルを処理 * PptxGenJS APIを使用してプレースホルダー領域にチャートとテーブルを追加 * `pptx.writeFile()`を使用してプレゼンテーションを保存 4. ビジュアル検証 : サムネイルを生成してレイアウトの問題を確認 * サムネイルグリッドを作成: `python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4` * サムネイル画像を読み取り、以下を注意深く確認： * テキスト切れ : ヘッダーバー、シェイプ、またはスライドエッジによるテキスト切れ * テキスト重なり : 他のテキストやシェイプとのテキスト重なり * 位置の問題 : スライド境界や他の要素に近すぎるコンテンツ * コントラストの問題 : テキストと背景間のコントラスト不足 * 問題が見つかった場合、HTMLのマージン/間隔/色を調整してプレゼンテーションを再生成 * すべてのスライドが視覚的に正しくなるまで繰り返す ## 既存のPowerPointプレゼンテーションを編集既存のPowerPointプレゼンテーションでスライドを編集する場合は、Raw Office Open XML（OOXML）形式で作業する必要があります。これには.pptxファイルを展開し、XMLコンテンツを編集し、再パックする必要があります。 ### ワークフロー 1. 必須 - ファイル全体を読む : [`ooxml.md`]()（約500行）を最初から最後まで完全に読んでください。このファイルを読む際に範囲制限を設定しないでください。プレゼンテーション編集の前に、OOXML構造と編集ワークフローの詳細なガイダンスについてファイル全体を読んでください。 2. プレゼンテーションを展開: `python ooxml/scripts/unpack.py ` 3. XMLファイルを編集（主に`ppt/slides/slide{N}.xml`と関連ファイル） 4. 重要 : 各編集後すぐに検証し、続行前にバリデーションエラーを修正: `python ooxml/scripts/validate.py --original ` 5. 最終プレゼンテーションをパック: `python ooxml/scripts/pack.py ` ## テンプレートを使用して新規PowerPointプレゼンテーションを作成既存テンプレートのデザインに従うプレゼンテーションを作成する必要がある場合は、テンプレートスライドを複製・再配置してからプレースホルダーコンテキストを置き換えます。 ### ワークフロー 1. テンプレートテキストを抽出しビジュアルサムネイルグリッドを作成 : * テキストを抽出: `python -m markitdown template.pptx > template-content.md` * `template-content.md`を読む: テンプレートプレゼンテーションの内容を理解するためにファイル全体を読んでください。このファイルを読む際に範囲制限を設定しないでください。 * サムネイルグリッドを作成: `python scripts/thumbnail.py template.pptx` * 詳細はサムネイルグリッドの作成セクションを参照 2. テンプレートを分析してインベントリをファイルに保存 : * ビジュアル分析 : サムネイルグリッドをレビューしてスライドレイアウト、デザインパターン、ビジュアル構造を理解 * `template-inventory.md`にテンプレートインベントリファイルを作成して保存： # テンプレートインベントリ分析総スライド数: [数] 重要: スライドは0インデックス（最初のスライド = 0、最後のスライド = count-1） ## [カテゴリ名] - スライド0: [利用可能な場合はレイアウトコード] - 説明/目的 - スライド1: [レイアウトコード] - 説明/目的 - スライド2: [レイアウトコード] - 説明/目的 [... すべてのスライドを個別にインデックス付きでリスト ...] 3. テンプレートインベントリに基づいてプレゼンテーションアウトラインを作成 : * ステップ2で利用可能なテンプレートをレビュー * 最初のスライドにはイントロまたはタイトルテンプレートを選択 * 他のスライドには安全なテキストベースのレイアウトを選択 * 重要: レイアウト構造を実際のコンテンツに合わせる * 選択したレイアウトをコンテンツマッピングと共に`outline.md`に保存 4. `rearrange.py`を使用してスライドを複製、並べ替え、削除: python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52 5. `inventory.py`スクリプトを使用してすべてのテキストを抽出: python scripts/inventory.py working.pptx text-inventory.json * text-inventory.jsonを読む : すべてのシェイプとそのプロパティを理解するためにtext-inventory.jsonファイル全体を読んでください。 6. 置換テキストを生成してJSONファイルにデータを保存 * 前のステップのテキストインベントリに基づいて置換コンテンツを生成 * 更新されたインベントリを`replacement-text.json`に保存 7. `replace.py`スクリプトを使用して置換を適用 python scripts/replace.py working.pptx replacement-text.json output.pptx ## サムネイルグリッドの作成要为 PowerPoint 幻灯片创建可视化缩略图网格以供快速分析和参考： python 脚本/thumbnail.py template.pptx [输出前缀] 特点： * 创建：`thumbnails.jpg`（或者对于大型套牌，`thumbnails-1.jpg`、`thumbnails-2.jpg` 等） * 默认：5 列，每个网格最多 30 张幻灯片 (5x6) * 自定义前缀：`python script/thumbnail.py template.pptx my-grid` * 列调整：`--cols 4`（范围：3-6，影响每个网格的幻灯片数量） * 网格限制：3 列 = 12 张幻灯片/网格，4 列 = 20，5 列 = 30，6 列 = 42 * 幻灯片的索引为零（幻灯片 0、幻灯片 1 等） ## 将幻灯片转换为图像要直观地分析 PowerPoint 幻灯片，请分两步将其转换为图像： 1. 将 PPTX 转换为 PDF : soffice --headless --convert-to pdf template.pptx 2. 将 PDF 页面转换为 JPEG 图像 : pdftoppm -jpeg -r 150 模板.pdf 幻灯片这将创建“slide-1.jpg”和“slide-2.jpg”等文件。 ## 代码风格指南重要：生成 PPTX 操作的代码时： * 编写简洁的代码 * 避免冗余变量名和重复操作 * 避免不必要的打印语句 ## 依赖关系所需的依赖项（应该已安装）： * markitdown : `pip install "markitdown[pptx]"` （用于从演示文稿中提取文本） * pptxgenjs : `npm install -g pptxgenjs` （用于使用 html2pptx 创建演示文稿） * playwright : `npm install -g playwright` （用于使用 html2pptx 渲染 HTML） * react-icons : `npm install -g React-icons React React-dom` (对于图标) * sharp : `npm install -g Sharp` （用于 SVG 光栅化和图像处理） * LibreOffice ： `sudo apt-get install libreoffice` （用于 PDF 转换） * Poppler ： `sudo apt-get install poppler-utils` （使用 pdftoppm 将 PDF 转换为图像） * defusedxml : `pip install defusedxml` （用于安全 XML 解析）

PPTX

包含技能