PPTXの作成、編集、分析
概要
ユーザーが.pptxファイルの作成、編集、または内容の分析を依頼する場合があります。.pptxファイルは本質的に、XMLファイルやその他のリソースを含むZIPアーカイブであり、読み取りや編集が可能です。タスクに応じて、利用可能なさまざまなツールとワークフローがあります。
コンテンツの読み取りと分析
テキスト抽出
プレゼンテーションのテキスト内容を読むだけでよい場合は、ドキュメントをマークダウンに変換します。
# ドキュメントをマークダウンに変換
python -m markitdown path-to-file.pptx
生のXMLへのアクセス
コメント、スピーカーノート、スライドレイアウト、アニメーション、デザイン要素、複雑な書式設定には、生のXMLアクセスが必要です。これらの機能については、プレゼンテーションを解凍し、その生のXML内容を読み取る必要があります。
ファイルの解凍
python ooxml/scripts/unpack.py <office_file> <output_dir>
注: 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/- 画像およびその他のメディアファイル
タイポグラフィと色の抽出
模倣すべきデザイン例が与えられた場合: 以下の方法を使用して、最初にプレゼンテーションのタイポグラフィと色を常に分析します。
- テーマファイルを読む:
ppt/theme/theme1.xmlで色(<a:clrScheme>)とフォント(<a:fontScheme>)を確認する - スライドコンテンツをサンプリングする:
ppt/slides/slide1.xmlで実際のフォント使用(<a:rPr>)と色を調べる - パターンを検索する: すべてのXMLファイルにわたって、色(
<a:solidFill>、<a:srgbClr>)とフォント参照を見つけるためにgrepを使用する
テンプレートなしでの新しいPowerPointプレゼンテーションの作成
新しいPowerPointプレゼンテーションをゼロから作成する場合は、html2pptx ワークフローを使用してHTMLスライドを正確な配置でPowerPointに変換します。
デザインの原則
重要: プレゼンテーションを作成する前に、内容を分析し、適切なデザイン要素を選択してください。
- 主題を考慮する: このプレゼンテーションは何についてですか?どんなトーン、業界、雰囲気を示唆していますか?
- ブランディングを確認する: ユーザーが会社/組織を言及している場合は、そのブランドカラーとアイデンティティを考慮する
- パレットを内容に合わせる: 主題を反映する色を選択する
- アプローチを説明する: コードを書く前にデザインの選択を説明する
要件:
- ✅ コードを書く前に、内容に基づいたデザインアプローチを説明する
- ✅ ウェブセーフフォントのみを使用する: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
- ✅ サイズ、太さ、色を通じて明確な視覚的階層を作成する
- ✅ 読みやすさを確保する: 強いコントラスト、適切なサイズのテキスト、クリーンな配置
- ✅ 一貫性を保つ: スライド間でパターン、間隔、視覚言語を繰り返す
カラーパレットの選択
創造的な色の選択:
- デフォルトを超えて考える: この特定のトピックに本当に合う色は何ですか?オートパイロットの選択は避けてください。
- 複数の角度を考慮する: トピック、業界、ムード、エネルギーレベル、ターゲットオーディエンス、ブランドアイデンティティ(言及されている場合)
- 冒険的になる: 意外な組み合わせを試してみる - ヘルスケアのプレゼンテーションが緑である必要はなく、金融がネイビーである必要もありません
- パレットを構築する: 一緒に機能する3〜5色を選ぶ(支配的な色 + サポートトーン + アクセント)
- コントラストを確保する: テキストが背景で明確に読める必要があります
カラーパレットの例(創造性を刺激するために使用 - 選択、適応、または独自のものを作成):
- クラシックブルー: 濃紺 (#1C2833)、スレートグレー (#2E4053)、シルバー (#AAB7B8)、オフホワイト (#F4F6F6)
- ティール&コーラル: ティール (#5EA8A7)、ダークティール (#277884)、コーラル (#FE4447)、ホワイト (#FFFFFF)
- ボールドレッド: レッド (#C0392B)、ブライトレッド (#E74C3C)、オレンジ (#F39C12)、イエロー (#F1C40F)、グリーン (#2ECC71)
- ウォームブラッシュ: モーヴ (#A49393)、ブラッシュ (#EED6D3)、ローズ (#E8B4B8)、クリーム (#FAF7F2)
- バーガンディラグジュアリー: バーガンディ (#5D1D2E)、クリムゾン (#951233)、ラスト (#C15937)、ゴールド (#997929)
- ディープパープル&エメラルド: パープル (#B165FB)、ダークブルー (#181B24)、エメラルド (#40695B)、ホワイト (#FFFFFF)
- クリーム&フォレストグリーン: クリーム (#FFE1C7)、フォレストグリーン (#40695B)、ホワイト (#FCFCFC)
- ピンク&パープル: ピンク (#F8275B)、コーラル (#FF574A)、ローズ (#FF737D)、パープル (#3D2F68)
- ライム&プラム: ライム (#C5DE82)、プラム (#7C3A5F)、コーラル (#FD8C6E)、ブルーグレー (#98ACB5)
- ブラック&ゴールド: ゴールド (#BF9A4A)、ブラック (#000000)、クリーム (#F4F6F6)
- セージ&テラコッタ: セージ (#87A96B)、テラコッタ (#E07A5F)、クリーム (#F4F1DE)、チャコール (#2C2C2C)
- チャコール&レッド: チャコール (#292929)、レッド (#E33737)、ライトグレー (#CCCBCB)
- ビブラントオレンジ: オレンジ (#F96D00)、ライトグレー (#F2F2F2)、チャコール (#222831)
- フォレストグリーン: ブラック (#191A19)、グリーン (#4E9F3D)、ダークグリーン (#1E5128)、ホワイト (#FFFFFF)
- レトロレインボー: パープル (#722880)、ピンク (#D72D51)、オレンジ (#EB5C18)、アンバー (#F08800)、ゴールド (#DEB600)
- ヴィンテージアーシー: マスタード (#E3B448)、セージ (#CBD18F)、フォレストグリーン (#3A6B35)、クリーム (#F4F1DE)
- コースタルローズ: オールドローズ (#AD7670)、ビーバー (#B49886)、エッグシェル (#F3ECDC)、アッシュグレー (#BFD5BE)
- オレンジ&ターコイズ: ライトオレンジ (#FC993E)、グレイッシュターコイズ (#667C6F)、ホワイト (#FCFCFC)
ビジュアル詳細オプション
幾何学模様:
- 水平ではなく斜めのセクション区切り
- 非対称のカラム幅(30/70、40/60、25/75)
- 90°または270°で回転したテキストヘッダー
- 画像用の円形/六角形フレーム
- コーナーにある三角形のアクセント形状
- 奥行きを出すための重なり合う形状
境界線とフレームの処理:
- 片側のみの太い単色境界線(10-20pt)
- 対照的な色の二重線境界線
- 完全なフレームの代わりにコーナーブラケット
- L字型の境界線(上+左または下+右)
- ヘッダーの下にある下線アクセント(3-5ptの太さ)
タイポグラフィ処理:
- 極端なサイズのコントラスト(72ptの見出し vs 11ptの本文)
- 文字間隔を広くしたすべて大文字のヘッダー
- 特大のディスプレイタイプでの番号付きセクション
- データ/統計/技術コンテンツには等幅フォント(Courier New)
- 密集した情報にはコンデンスフォント(Arial Narrow)
- 強調のためのアウトラインテキスト
チャートとデータのスタイリング:
- 主要なデータに単一のアクセントカラーを使用したモノクロームチャート
- 垂直ではなく水平の棒グラフ
- 棒グラフの代わりのドットプロット
- 最小限のグリッド線、またはまったくなし
- 凡例なしで要素に直接データラベル
- 主要な指標のための特大の数字
レイアウトの革新:
- テキストオーバーレイ付きのフルブリード画像
- ナビゲーション/コンテキストのためのサイドバーカラム(20-30%幅)
- モジュラーグリッドシステム(3×3、4×4ブロック)
- ZパターンまたはFパターンのコンテンツフロー
- 色付き形状の上のフローティングテキストボックス
- マガジンスタイルのマルチカラムレイアウト
背景処理:
- スライドの40-60%を占める単色ブロック
- グラデーション塗りつぶし(垂直または斜めのみ)
- 分割背景(2色、斜めまたは垂直)
- 端から端までのカラーバンド
- デザイン要素としてのネガティブスペース
レイアウトのヒント
チャートやテーブルを含むスライドを作成する場合:
- 二カラムレイアウト(推奨): 全幅にまたがるヘッダーを使用し、その下に2列を配置 - 一方の列にテキスト/箇条書き、もう一方の列に注目コンテンツ。これによりバランスが向上し、チャートやテーブルが読みやすくなります。各コンテンツタイプに最適なスペースを確保するために、異なるカラム幅(例:40%/60%の分割)でフレックスボックスを使用します。
- フルスライドレイアウト: 最大のインパクトと読みやすさのために、注目コンテンツ(チャート/テーブル)をスライド全体に表示します
- 絶対に垂直に積み重ねない: チャートやテーブルをテキストの下に単一列で配置しないでください - これにより読みやすさとレイアウトの問題が発生します
ワークフロー
- 必須 - ファイル全体を読む:
html2pptx.mdを最初から最後まで完全に読みます。このファイルを読む際には、決して範囲制限を設定しないでください。 プレゼンテーション作成に進む前に、詳細な構文、重要な書式設定ルール、ベストプラクティスについてファイルの全文を読んでください。 - 各スライドに適切な寸法(例:16:9の場合は720pt × 405pt)でHTMLファイルを作成する
- すべてのテキストコンテンツに
<p>、<h1>-<h6>、<ul>、<ol>を使用する - チャートやテーブルが追加される領域には
class="placeholder"を使用する(視認性のためにグレーの背景でレンダリング) - 重要: 最初にSharpを使用してグラデーションとアイコンをPNG画像としてラスタライズし、その後HTMLで参照する
- レイアウト: チャート/テーブル/画像があるスライドでは、読みやすさを向上させるためにフルスライドレイアウトまたは二カラムレイアウトのいずれかを使用する
- すべてのテキストコンテンツに
html2pptx.jsライブラリを使用するJavaScriptファイルを作成して実行し、HTMLスライドをPowerPointに変換してプレゼンテーションを保存するhtml2pptx()関数を使用して各HTMLファイルを処理する- PptxGenJS APIを使用してプレースホルダー領域にチャートとテーブルを追加する
pptx.writeFile()を使用してプレゼンテーションを保存する
- 視覚的検証: サムネイルを生成し、レイアウトの問題を検査する
- サムネイルグリッドを作成する:
python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 - サムネイル画像を読み込み、注意深く検査する:
- テキストの切れ: テキストがヘッダーバー、形状、またはスライドの端で切れていないか
- テキストの重なり: テキストが他のテキストや形状と重なっていないか
- 配置の問題: コンテンツがスライドの境界や他の要素に近すぎないか
- コントラストの問題: テキストと背景の間のコントラストが不十分でないか
- 問題が見つかった場合、HTMLの余白/間隔/色を調整し、プレゼンテーションを再生成する
- すべてのスライドが視覚的に正しくなるまで繰り返す
- サムネイルグリッドを作成する:
既存のPowerPointプレゼンテーションの編集
既存のPowerPointプレゼンテーションのスライドを編集する場合、生のOffice Open XML(OOXML)形式で作業する必要があります。これには、.pptxファイルの解凍、XMLコンテンツの編集、再パックが含まれます。
ワークフロー
- 必須 - ファイル全体を読む:
ooxml.md(約500行)を最初から最後まで完全に読みます。このファイルを読む際には、決して範囲制限を設定しないでください。 プレゼンテーション編集の前に、OOXML構造と編集ワークフローに関する詳細なガイダンスのためにファイルの全文を読んでください。 - プレゼンテーションを解凍する:
python ooxml/scripts/unpack.py <office_file> <output_dir> - XMLファイル(主に
ppt/slides/slide{N}.xmlおよび関連ファイル)を編集する - 重要: 各編集後すぐに検証し、次に進む前に検証エラーを修正する:
python ooxml/scripts/validate.py <dir> --original <file> - 最終的なプレゼンテーションをパックする:
python ooxml/scripts/pack.py <input_directory> <office_file>
テンプレートを使用した新しいPowerPointプレゼンテーションの作成
既存のテンプレートのデザインに従うプレゼンテーションを作成する必要がある場合、テンプレートスライドを複製して再配置し、その後プレースホルダーのコンテキストを置き換える必要があります。
ワークフロー
-
テンプレートテキストを抽出し、視覚的なサムネイルグリッドを作成する:
- テキストを抽出する:
python -m markitdown template.pptx > template-content.md template-content.mdを読む: テンプレートプレゼンテーションの内容を理解するためにファイル全体を読む。このファイルを読む際には、決して範囲制限を設定しないでください。- サムネイルグリッドを作成する:
python scripts/thumbnail.py template.pptx - 詳細については、サムネイルグリッドの作成セクションを参照してください
- テキストを抽出する:
-
テンプレートを分析し、インベントリをファイルに保存する:
- 視覚的分析: サムネイルグリッドを確認して、スライドレイアウト、デザインパターン、視覚構造を理解する
template-inventory.mdにテンプレートインベントリファイルを作成して保存する:# テンプレートインベントリ分析 **総スライド数: [数]** **重要: スライドは0から始まります(最初のスライド = 0、最後のスライド = 数-1)** ## [カテゴリ名] - スライド 0: [利用可能な場合のレイアウトコード] - 説明/目的 - スライド 1: [レイアウトコード] - 説明/目的 - スライド 2: [レイアウトコード] - 説明/目的 [... すべてのスライドを個別にインデックスと共にリストする ...]- サムネイルグリッドの使用: 視覚的なサムネイルを参照して以下を特定する:
- レイアウトパターン(タイトルスライド、コンテンツレイアウト、セクション区切り)
- 画像プレースホルダーの位置と数
- スライドグループ全体のデザインの一貫性
- 視覚的階層と構造
- このインベントリファイルは、次のステップで適切なテンプレートを選択するために必須です
-
テンプレートインベントリに基づいてプレゼンテーションの概要を作成する:
- ステップ2で利用可能なテンプレートを確認する。
- 最初のスライドには、イントロまたはタイトルテンプレートを選択する。これは最初のテンプレートの1つである必要があります。
- 他のスライドには、安全でテキストベースのレイアウトを選択する。
- 重要: レイアウト構造を実際のコンテンツに一致させる:
- 単一カラムレイアウト: 統一されたナラティブまたは単一のトピックに使用
- 二カラムレイアウト: 正確に2つの異なるアイテム/コンセプトがある場合にのみ使用
- 三カラムレイアウト: 正確に3つの異なるアイテム/コンセプトがある場合にのみ使用
- 画像 + テキストレイアウト: 実際に挿入する画像がある場合にのみ使用
- 引用レイアウト: 人からの実際の引用(出典付き)にのみ使用し、強調には使用しない
- コンテンツよりも多くのプレースホルダーがあるレイアウトは絶対に使用しない
- 2つのアイテムがある場合、3カラムレイアウトに無理やり入れない
- 4つ以上のアイテムがある場合、複数のスライドに分割するか、リスト形式を使用することを検討する
- レイアウトを選択する前に、実際のコンテンツの数を数える
- 選択したレイアウトの各プレースホルダーが意味のあるコンテンツで埋められることを確認する
- 各コンテンツセクションに最適なレイアウトを表す1つのオプションを選択する
- 利用可能なデザインを活用するコンテンツとテンプレートマッピングを含む
outline.mdを保存する - テンプレートマッピングの例:
(翻訳が長文のため省略)