PPTXの作成、編集、分析
.pptxはXMLファイルのZIPアーカイブです。タスクに応じてアプローチを選択してください:
| タスク | アプローチ |
|---|---|
| 新しいデッキの作成 | pptxgenjsスクリプトを作成します — 以下の注意点を参照 |
| 既存デッキの編集、テンプレートからの構築 | 解凍 → ppt/slides/slideN.xmlを編集 → 圧縮 |
| コンテンツの読み取り | markitdown deck.pptx(各スライドは<!-- Slide number: N -->マーカーで区切られます); 視覚グリッド: python scripts/thumbnail.py deck.pptx |
スクリプト
パスはこのスキルのディレクトリからの相対パスです。それ以外はプレーンなPython、Node、またはシェルです。
| スクリプト | 機能 |
|---|---|
scripts/thumbnail.py deck.pptx [prefix] | すべてのスライドのラベル付きグリッドを作成し、テンプレートレイアウトを選択するために使用します。.pptxのみ対応。prefixを指定します(デフォルトはthumbnailsで、同じディレクトリ内の他のデッキのグリッドを上書きします) |
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml] | スライド(またはslideLayoutN.xml)を複製し、パッケージのブックキーピングをすべて行います。-o out.pptxオプションで.pptxファイルを直接受け取ることもできます |
scripts/clean.py unpacked/ | 参照されなくなったスライド、メディア、relsを削除します。<p:sldIdLst>が最終確定した後に実行してください |
scripts/office/validate.py deck.pptx [--original src.pptx] | スキーマ、リレーションシップ、コンテンツタイプ、チャート、スライドのチェックを行い、各障害に対してその修正方法を表示します。テンプレートから派生したデッキには--originalを指定します — テンプレートのスキーマチェックをベースライン化するため、テンプレート自身のXSDエラーがあなたのエラーとして表示されなくなります |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx | LibreOfficeラッパー — プレーンなsofficeはこのサンドボックスでハングします |
pptxgenjsを使用した作成 — 注意点
pptxgenjsはプリインストールされています — npm installを最初に実行せず、スクリプトを作成してrequire('pptxgenjs')を直接使用してください。そのrequireが失敗した場合のみ、npm install pptxgenjsを実行します。モデルはAPIを認識していますが、以下が落とし穴です:
- スライドを追加する前に
pres.layoutを設定してください。 デフォルトのキャンバスはLAYOUT_16x9= 10" × 5.625" であり、13.3"幅ではありません。端を超える座標は書き込まれてもクランプされず、形状は単にスライド上に表示されません。(LAYOUT_WIDEは13.3" × 7.5"です。) - 16進数カラー:
#は使用せず、8桁にもしないでください。color: "FF0000"と指定します。"#FF0000"と、16進数にアルファ値を含めること("00000020")は、どちらもファイルを破損させます。半透明には、塗りつぶしと画像にはtransparency: 0-100、影にはopacity: 0.0-1.0を使用します — それぞれ相手側では静かに無視されます。 - pptxgenjsはオプションオブジェクトをその場で変更します(最初の使用時に値をEMUに変換します)。2回以上の
add*呼び出しで1つのshadow/optionsオブジェクトを共有しないでください — 毎回新しいオブジェクトを作成してください。 - 影の
offsetは0以上である必要があります — 負のオフセットはファイルを破損させます。上向きの影を投影するには、正のオフセットでangle: 270を使用してください。 letterSpacingは静かに無視されます — 実際のオプションはcharSpacingです。- リスト: 各項目に
bullet: trueを設定し、リテラルの•は使用しないでください(二重の箇条書きになります)。最後の項目を除くすべての配列項目にbreakLine: trueを設定します。箇条書きの段落間のスペースはparaSpaceAfterで設定し、lineSpacingは使用しないでください(大きなギャップができます)。 - 出力ファイルごとに1つの
new pptxgen()— インスタンスを再利用しないでください。 rectRadiusはROUNDED_RECTANGLEでのみ機能し、RECTANGLEでは機能しません。- グラデーション塗りつぶしはサポートされていません — 代わりにグラデーション画像を背景として使用してください。
- テキストボックスには内部パディングが組み込まれています — テキストを同じxの図形、線、またはアイコンに合わせる必要がある場合は、
margin: 0を設定してください。 - スピーカーノートは
slide.addNotes("...")(プレーンテキスト、スライドごとに1回)に記述し、スライド上のテキストボックスには記述しないでください。 - チャートはネイティブに保ってください。 PowerPointでチャート化できるすべてのものには
addChart()を使用します(コンボの場合は{type, data, options}の配列を渡します)。ライブラリが公開していないPowerPointネイティブ機能(トレンドライン、エラーバー)については、自分で追加の系列を計算するか、生成されたOOXMLを後処理してください — レンダリングされた画像にフォールバックしないでください。PowerPointにネイティブフォームがないチャートタイプ(Sankey、ネットワーク、コード)のみ画像として配置します。 - デフォルトのチャートは裸でレンダリングされます — タイトルなし、データラベルなし、時代遅れのパレットです。
showTitle+title、showValue: true+dataLabelPosition、chartColors: [...](あなたのパレットから)、フレームを静かにする(catAxisLabelColor/valAxisLabelColor、valGridLine: { color, size }、catGridLine: { style: "none" }、単一系列の場合はshowLegend: false)を設定してください。 - 積み上げ棒グラフまたは縦棒グラフでは、
dataLabelPositionはctr、inEnd、またはinBaseでなければなりません。outEndはファイルを破損させます。 secondaryValAxis/secondaryCatAxisを使用するコンボ系列は、チャートオプションにvalAxesとcatAxesの両方を、それぞれ2エントリずつ必要とします。 これらがないと、pptxgenjsは宣言しない軸IDを書き込み、PowerPointはそのチャートを破棄し、ファイルを破損として報告します。valAxesのみを提供するだけでは不十分です。writeFile()の後、python scripts/office/validate.py deck.pptxを実行してください。 上記の2つのチャート障害と、PowerPointが拒否するスライドXMLの欠陥を報告し、それぞれの修正方法を示します。生成プログラム内で修正し、パッケージ化されたXMLを手動編集しないでください。<p:presentation>の子要素を並べ替えないでください。 pptxgenjsは<p:sldIdLst>の直後に<p:notesMasterIdLst>を書き込み、両方のマスターを1つのテーマ部分にポイントします。PowerPointはそれを問題なく読み取りますが、その要素を移動すると、同じデッキが開けなくなります。- アイコン:
react-iconsをSVGにレンダリングし(ReactDOMServer.renderToStaticMarkup)、sharpで≥256pxにラスタライズし、addImage({ data: "image/png;base64," + buf.toString("base64") })で挿入します —image/png;base64,プレフィックスは必須です(react-icons、react、react-dom、sharpはプリインストールされています — requireが失敗した場合のみnpm install react-icons react react-dom sharpを実行します)。
既存のデッキとテンプレートの編集
最初にレイアウトを選択します:python scripts/thumbnail.py template.pptx template-thumbsは、すべてのスライドのラベル付きグリッドを作成し、作成したファイルを表示します — template-thumbs.jpgを、12スライドを超えるとtemplate-thumbs-N.jpgに分割します。常にその2番目の引数(デッキにちなんだ名前)を渡してください。 デフォルトはthumbnailsなので、同じディレクトリで2つのデッキのサムネイルを作成すると、互いのグリッドを静かに上書きします — 最初のデッキのものは単純に失われます(テンプレート解析のみ — 視覚的なQAには画像への変換からのフル解像度レンダリングが必要です;.pptxのみを受け付けるので、最初に.potxを.pptx名にコピーしてから使用してください)。markitdownと組み合わせて、各コンテンツセクションをテンプレートスライドにマッピングし、レイアウトを変化させてください — すべてのセクションを同じタイトルと箇条書きのスライドに配置しないでください。
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml # スライド(またはslideLayoutN.xml)を複製します;新しいスライドのパスを表示します
# スライドの並び替え/削除 = ppt/presentation.xml の <p:sldIdLst> を編集します
python scripts/clean.py unpacked/ # 削除後:孤立したスライド、メディア、relsを削除します
# ppt/slides/slideN.xml でスライドコンテンツを編集します
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .) # ディレクトリ内部から圧縮します;最初にrmしないと、削除された部分が残ります
python scripts/office/validate.py out.pptx --original deck.pptx
- すべての構造的な作業(追加、削除、並び替え)は、スライドのコンテンツを編集する前に行ってください。
add_slide.pyはスライドファイルをそのままコピーするため、編集後に複製すると編集済みのコンテンツがクローンされます。また、clean.pyは<p:sldIdLst>に存在しないスライドを削除します。これには書き込んだばかりのスライドも含まれます。 - スライドファイルを手動でコピーしないでください —
add_slide.pyは、新しいスライドに必要なすべての登録を行い、作成したものを報告します(Created ppt/slides/slide17.xml from slide2.xml)。ファイルに対して直接動作することもできます:add_slide.py deck.pptx slide2.xml -o out.pptx—-oを渡してください。渡さないと、入力デッキをその場で上書きします。 複製されたスライドは、そのソースのチャート/SmartArt/埋め込みオブジェクト部分を複製せずに参照するため、一方のスライドのチャートを編集すると、もう一方のスライドのチャートも変更されます。 python-pptxを使用する場合、次の3つのことはできません:スライドの複製(エントリポイントはadd_slide(layout)のみ)、text_frame.text = "..."による書式の保持(段落をスタイルのない単一のランに折りたたみます — 代わりにrun.textを割り当ててください)、ほとんどのテンプレートアートで使用されるSVG/EMFの読み取り(add_pictureはUnidentifiedImageErrorを発生させます)。- レガシーな
.pptは最初に変換する必要があります:python scripts/office/soffice.py --headless --convert-to pptx file.ppt。.potxテンプレートは、解凍と圧縮が同じように機能します — 出力の拡張子は.potxのままにしてください。 - テンプレートのアイコンや画像を再利用するには、それを既に含むスライドまたはレイアウトを複製してください。
テンプレートを埋めるとき:
- XML変換をスクリプト化する場合は、
defusedxml.minidomでパースしてください —xml.etree.ElementTreeを介してOOXMLをラウンドトリップすると、名前空間プレフィックスが書き換えられ、デッキが破損します。 - テンプレートのスロット ≠ ソースアイテム。 テンプレートに4人のチームメンバーが表示されていて、あなたが3人しかいない場合は、4人目のメンバー全体のグループ(画像+テキストボックス)を削除し、テキストだけを削除しないでください — その後、QAで孤立したビジュアルがないか確認してください。
- リスト項目ごとに1つの
<a:p>— 複数の項目を単一の段落に連結しないでください。間隔を維持するために兄弟の<a:pPr>をコピーし、タイトル、セクションヘッダー、インラベルの(Status:,Owner:)には<a:rPr>にb="1"を設定してください。 - 箇条書きはレイアウトから継承させ、オーバーライドする場合にのみ
<a:buChar>、<a:buAutoNum>(番号付き)、または<a:buNone>を追加してください — テキスト内にリテラルの•を決して使用しないでください。 - 先頭または末尾にスペースがあるテキストは、その
<a:t>にxml:space="preserve"が必要です。
デザインのアイデア
退屈なスライドを作成しないでください。 白い背景にプレーンな箇条書きは誰も感心させません。各スライドに、このリストからのアイデアを検討してください。
開始前
- 大胆で、コンテンツに基づいたカラーパレットを選んでください:パレットは、このトピックのためにデザインされたように感じられるべきです。あなたの色を完全に異なるプレゼンテーションに交換しても「機能する」場合、あなたは十分に具体的な選択をしていません。
- 平等よりも支配:1色が支配的(60-70%の視覚的重み)で、1-2の補助トーンと1つのシャープなアクセントを持つべきです。すべての色に均等な重みを与えないでください。
- ダーク/ライトのコントラスト:タイトルスライドと結論スライドには暗い背景、コンテンツスライドには明るい背景(「サンドイッチ」構造)。または、プレミアムな雰囲気のために全体を暗くすることもできます。
- 視覚的モチーフにコミットする:1つの特徴的な要素を選び、それを繰り返します — 丸みを帯びた画像フレーム、色付きの円の中のアイコン。それをすべてのスライドで実行します。モチーフとしてカラーバーやアクセントストライプを使用しないでください(避けるべきリストを参照)。
カラーパレット
トピックに合った色を選んでください — デフォルトの青にしないでください。これらのパレットをインスピレーションとして使用してください:
| テーマ | プライマリ | セカンダリ | アクセント |
|---|---|---|---|
| ミッドナイトエグゼクティブ | 1E2761 (ネイビー) | CADCFC (アイスブルー) | FFFFFF (ホワイト) |
| フォレスト&モス | 2C5F2D (フォレスト) | 97BC62 (モス) | F5F5F5 (クリーム) |
| コーラルエナジー | F96167 (コーラル) | F9E795 (ゴールド) | 2F3C7E (ネイビー) |
| ウォームテラコッタ | B85042 (テラコッタ) | E7E8D1 (サンド) | A7BEAE (セージ) |
| オーシャングラデーション | 065A82 (ディープブルー) | 1C7293 (ティール) | 21295C (ミッドナイト) |
| チャコールミニマル | 36454F (チャコール) | F2F2F2 (オフホワイト) | 212121 (ブラック) |
| ティールトラスト | 028090 (ティール) | 00A896 (シーフォーム) | 02C39A (ミント) |
| ベリー&クリーム | 6D2E46 (ベリー) | A26769 (ダスティローズ) | ECE2D0 (クリーム) |
| セージカーム | 84B59F (セージ) | 69A297 (ユーカリ) | 50808E (スレート) |
| チェリーボールド | 990011 (チェリー) | FCF6F5 (オフホワイト) | 2F3C7E (ネイビー) |
各スライドについて
すべてのスライドには視覚的要素が必要です — 画像、チャート、アイコン、または図形。テキストのみのスライドは記憶に残りません。
レイアウトオプション:
- 2カラム(テキスト左、イラスト右)
- アイコン+テキスト行(色付きの円の中のアイコン、太字ヘッダー、下に説明)
- 2x2または2x3グリッド(片側に画像、反対側にコンテンツブロックのグリッド)
- ハーフブリード画像(左または右側全体)とコンテンツのオーバーレイ
データ表示:
- 大きな統計呼び出し(60-72ptの大きな数字と下に小さなラベル)
- 比較カラム(before/after、長所/短所、並列オプション)
- タイムラインまたはプロセスフロー(番号付きステップ、矢印)
視覚的な仕上げ:
- セクションヘッダーの横にある小さな色付きの円の中のアイコン
- 主要な統計やタグラインのためのイタリックのアクセントテキスト
タイポグラフィ
.pptxに書き込むフォント名は、この環境ではなく、ユーザーのPowerPointでレンダリングされます。 視覚的なQAはLibreOfficeを介してレンダリングされ、LibreOfficeは持っていないフォントを代替します — そして一部のフォントでは代替フォントの幅が異なるため、QAプレビューでは実際のデッキにはないテキストオーバーフロー(または収まり)が表示される可能性があります。QAを信頼できるものにするため:
- 安全なフォント(QAで正しい幅でレンダリングされ、Officeに同梱される):Arial、Calibri、Cambria、Times New Roman、Courier New、Bookman Old Style、Century Schoolbook。本文や収まりが重要なものにはこれらを使用してください。
- QAリスクゼロで個性のあるヘッダー:安全なリストのセリフヘッダー(Cambria、Bookman Old Style、Century Schoolbook)と安全なリストのサンズ本文(CalibriまたはArial)を組み合わせます。オーバーフローチェックの信頼性を犠牲にせずに視覚的なコントラストを得られます。
- ユーザーが安全なリスト外のフォントを要求した場合(例:GeorgiaやTrebuchet MS):ユーザーが要求した場所でそれを使用しますが、それらのコンテナには余分な余裕(約10%)を持たせ、それらの要素のQAテキスト収まりを信頼しないでください — そのフォントのプレビューは近似値です。ユーザーが指定していない場合は、本文には安全なリストのフォントを優先してください。
- QAで信頼できないフォント(代替フォントの幅が異なり、オーバーフローチェックが間違っている可能性があります):Georgia、Trebuchet MS、Impact、Arial Black、Garamond、Consolas、Palatino Linotype。Calibri Lightの代替は環境によって異なります。QAで信頼できないものとして扱ってください。タイトルやアクセントには余裕を持って使用できますが、これらのQAテキスト収まりは信頼しないでください。
- デフォルトでAptosを使用しないでください — Officeの2023年以降のデフォルトには、ここで互換性のあるメトリックの代替がなく、古いOfficeインストールには存在しないため、両端で信頼できません。
| 要素 | サイズ |
|---|---|
| スライドタイトル | 36-44pt 太字 |
| セクションヘッダー | 20-24pt 太字 |
| 本文 | 14-16pt |
| キャプション | 10-12pt ミュート |
…
[truncated for translation]