add_notes_pptx_com プログラム仕様

PowerPoint COM APIを使用して、指定されたPowerPointプレゼンテーションのノートにテキストを挿入するスクリプト。

このスクリプトは、特定の書式で記述されたテキストファイル(ナレーションファイル)を解析し、 #Slide n で指定されたスライド番号に対応するノートページにテキストを挿入します。 PowerPointアプリケーションをCOM経由で操作するため、Windows環境でのみ動作します。

関連リンク: add_notes_pptx_com.py の技術ドキュメント

ai.add_notes_pptx_com.insert_notes_com(pptx_path, narration_path, output_path=None)[ソース]

PowerPoint COM APIを使って、#Slide n で指定されたスライドのノート欄にテキストを追加する。

指定されたPowerPointファイルに対し、ナレーションファイルから読み込んだテキストを各スライドのノートページに挿入します。 ナレーションファイルは #Slide n というマーカーで各スライドのテキストを区切る必要があります。 スクリプトはPowerPointアプリケーションを起動し、指定されたプレゼンテーションを開き、 対応するスライドのノートテキストボックスにテキストを設定します。 処理後、プレゼンテーションを保存し、PowerPointアプリケーションを終了します。

パラメータ:
  • pptx_path -- str: ノートを挿入するPowerPointプレゼンテーションファイルのパス。

  • narration_path -- str: 各スライドのノートとして挿入するテキストを含むナレーションファイルのパス。 各スライドのテキストは #Slide n (nはスライド番号) で区切られている必要があります。

  • output_path -- str, optional: ノートが挿入されたプレゼンテーションの出力パス。 指定しない場合、元のPowerPointファイルを上書きします。

戻り値:

None: 処理が成功した場合、指定されたパスにノートが挿入されたプレゼンテーションを保存します。 エラーが発生した場合は例外が発生する可能性があります。