インストール
require('pptxgenjs')誰向けか
入力、出力、またはその両方として .pptx または .potx ファイルが関わるなら、この pptx ガイドを使う。スライド、ピッチ資料、プレゼンテーションの作成、およびテキストの読み取り、解析、抽出が含まれる。概要は編集、結合、分割、テンプレート、ノート、コメントも同じ範囲に置く。きっかけは:この種のファイルを開く、作る、または変更する必要があること。
タスクごとに経路を選ぶのであり、単一の GUI ではない。資料はエージェント製品の一覧を出しておらず、特定ソフトの独占だと捉えてはいけない。公式ガイドページは
https://raw.githubusercontent.com/anthropics/skills/main/skills/pptx/SKILL.md
3 分で最初の試行を終える
推奨する最初の経路は資料が明記したもの:pptxgenjs はすでにプリインストールされているので、先に npm install を実行しない。スクリプトを書いて実行する:
require('pptxgenjs')
前提:今の環境でこの require を実行できること。成功の合図:インポートが成功し、モジュール欠落を報告しないこと。これは読み取り専用の確認であり、すぐディスクにプレゼンテーションを書かない。require が失敗したときだけ、同じページの予備コマンド npm install pptxgenjs を使ってよい。予備インストールを既定の第一歩にしない。
インポートが成功し、新しいファイルを作ると確認したら、.pptx を生成するスクリプトを書く。ディスク書き込みの前に、出力ファイル名と既存稿の上書き有無を確認する。概要は読み取りに markitdown または thumbnail.py を使えると述べるが、抜粋は markitdown の完全な呼び出しを書いていない。thumbnail.py には上書きリスクがある(下の事例を見よ)。最初にサムネイルを走らせない。
利用例
例 1:新しいプレゼンテーションを作る。経路は pptxgenjs:スクリプトを書き、直接 require('pptxgenjs') し、先に npm install しない。資料は .pptx を XML ファイルからなる ZIP と説明し、タスクごとに方法を選ぶとする。新規作成は pptxgenjs、編集は解凍/スライド XML の変更/再パック、読み取りは概要の markitdown または thumbnail.py。この例は新規作成だけをカバーする。完了基準はスクリプトが require に成功し、出力パスを確認したあと .pptx を 1 つ生成すること。抜粋は具体的なスライド API を出していないので、現れないページレイアウト関数名を作らない。
例 2:既存稿のサムネイルグリッドを生成する前に、上書きを避ける。資料は prefix を必ず渡すと書く。既定は thumbnails で、同じディレクトリ内の他のプレゼンテーションのグリッドを上書きする。概要は第 2 引数を稿の名前に合わせるよう求める。副作用のあるコマンドである。衝突しない prefix を選び、同名グリッドがディレクトリにないことを確認してから実行する。完了基準は、今回の出力用に独立した prefix を用意したことであり、既定の thumbnails を使い回さないこと。
利用上の境界
.pptx は XML の ZIP であり、方法はタスクごとに選ぶ。新規作成はプリインストール済み pptxgenjs、編集は XML を変え、読み取りでは最初からパッケージを入れるのを既定にしない。require が失敗したときだけ npm install pptxgenjs。サムネイルの既定 prefix は同じディレクトリの他グリッドを上書きする。
現れないリポジトリパスをインストールコマンドとして書かない。概要の markitdown、結合、分割などの能力に完全なコマンドがなければ、「資料が名指しした、手順は展開されていない」とだけ書く。ここに書いたきっかけ、require の順序、prefix の副作用を超える範囲は、この説明の対象外である。