PHP で PowerPoint プレゼンテーションを HTML に変換

概要

Aspose.Slides for PHP via Java は Microsoft PowerPoint を使用せずに PowerPoint プレゼンテーションを HTML として保存できます。基本的な変換は、単一の Presentation の読み込みと、SaveFormat を使用した save 呼び出しです。エクスポートされたレイアウト、フォント、画像、ノート、コメント、SVG 出力、またはリンクされたリソースを制御する必要がある場合は、HtmlOptions を使用します。

このガイドでは実用的な HTML エクスポートシナリオに焦点を当てます：

プレゼンテーション全体または選択したスライドをエクスポートする。
固定レイアウト、レスポンシブ、または SVG ベースの HTML を生成する。
スピーカーノートとコメントを含める。
画像品質と切り抜かれた画像データを制御する。
フォントを埋め込むか、フォントファイルを別々に保存する。
外部リソースやメディアファイルの書き込みおよび参照方法を選択する。

デフォルトでは、HTML エクスポートはほとんどのリソースが埋め込まれた単一の HTML ドキュメントを生成します。これは 1 つのファイルで共有するのに便利ですが、出力サイズが大きくなる可能性があります。Web 公開の場合は、外部リソースの使用、画像 DPI の低減、およびターゲット環境で確実に利用できないフォントのみを埋め込むことを検討してください。

プレゼンテーションを HTML に変換する

プレゼンテーションを HTML にエクスポートするには、Presentation で読み込み、SaveFormat.Html で保存します。

$presentation = new Presentation("presentation.pptx");
try {
    $presentation->save("presentation.html", SaveFormat::Html);
} finally {
    $presentation->dispose();
}

この例は 1 つの HTML ファイルを書き出します。プレゼンテーションオブジェクトは finally ブロックで破棄され、エクスポート後にファイルハンドルとレンダリングリソースが解放されます。

HtmlOptions の使用

HtmlOptions は HTML エクスポートの主要な設定クラスです。一般的な設定は次のとおりです。

SlidesLayoutOptions: ノート、コメント、配布資料、またはその他のレイアウト情報を追加します。
HtmlFormatter: HTML ドキュメントの構造を変更したり、フォーマッティングをコントローラーに委任したりします。
SlideImageFormat: スライドの表現方法を変更します。例として SVG があります。
PicturesCompression: 画像の DPI と出力サイズを制御します。
DeletePicturesCroppedAreas: 切り抜かれた画像データを保持または削除します。
SvgResponsiveLayout: エクスポートされた SVG コンテンツがコンテナに適応するようにします。
ShowHiddenSlides: 必要に応じて非表示スライドを含めます。

以下のセクションでは、最も一般的なオプションを個別に示すので、ワークフローで必要なものだけを組み合わせて使用できます。

選択したスライドを HTML に変換する

save のオーバーロードでスライド番号を受け取る場合は、1 から始まるスライド位置を使用します。以下のループは各スライドを別々の HTML ファイルに保存します。

$presentation = new Presentation("presentation.pptx");
try {
    $slideCount = java_values($presentation->getSlides()->size());

    for ($slideIndex = 0; $slideIndex < $slideCount; $slideIndex++) {
        $slideNumber = $slideIndex + 1;
        $slideNumbers = array($slideNumber);
        $htmlFileName = "slide-" . $slideNumber . ".html";

        $presentation->save($htmlFileName, $slideNumbers, SaveFormat::Html);
    }
} finally {
    $presentation->dispose();
}

ウェブサイトやアプリケーションでスライドごとに 1 ページの HTML が必要な場合にこのパターンを使用します。各スライドが同じレイアウトである場合は、1 つの HtmlOptions インスタンスを作成し、各 save 呼び出しに渡します。

レスポンシブ HTML の作成

ResponsiveHtmlController は HtmlFormatter を介してレスポンシブ HTML 出力を提供します。エクスポートされたページがブラウザ幅により適切に適応する必要がある場合に使用します。

$presentation = new Presentation("presentation.pptx");
try {
    $controller = new ResponsiveHtmlController();
    $formatter = java("com.aspose.slides.HtmlFormatter")->createCustomFormatter($controller);

    $htmlOptions = new HtmlOptions();
    $htmlOptions->setHtmlFormatter($formatter);

    $presentation->save("presentation-responsive.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

SVG ベースのレスポンシブレイアウトの場合は、HtmlOptions の SvgResponsiveLayout を設定します。スライドコンテンツがスケーラブルな SVG マークアップとしてエクスポートされる場合に便利です。

$presentation = new Presentation("presentation.pptx");
try {
    $htmlOptions = new HtmlOptions();
    $htmlOptions->setSvgResponsiveLayout(true);

    $presentation->save("presentation-svg-responsive.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

スピーカーノートとコメントの含め方

HtmlOptions.SlidesLayoutOptions を介して NotesCommentsLayoutingOptions を使用し、スピーカーノートまたはコメントを含めます。ノートとコメントはデフォルトで非表示で、位置を指定しない限り表示されません。

ソースプレゼンテーションにスピーカーノートが含まれているとします：

Slide with speaker notes in PowerPoint

以下のコードはスライドコンテンツをスライド下部にスピーカーノートを付けてエクスポートします。

$presentation = new Presentation("presentation.pptx");
try {
    $layoutOptions = new NotesCommentsLayoutingOptions();
    $layoutOptions->setNotesPosition(NotesPositions::BottomFull);

    $htmlOptions = new HtmlOptions();
    $htmlOptions->setSlidesLayoutOptions($layoutOptions);

    $presentation->save("presentation-with-notes.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

エクスポートされた HTML にはノート領域が含まれます：

HTML output with the slide and speaker notes

コメントをエクスポートするには、CommentsPosition を設定します。例えば CommentsPositions.Right または CommentsPositions.Bottom です。コメントだけが必要な場合は NotesPosition を省略します。ノートとコメントの両方が必要な場合は、両方のプロパティを設定します。

画像品質と切り抜き領域の制御

HTML エクスポートはスライド画像を圧縮して出力サイズを減らすことができます。より高い画像品質が必要な場合は、PicturesCompression の値で PicturesCompression を設定します。

$presentation = new Presentation("presentation.pptx");
try {
    $htmlOptions = new HtmlOptions();
    $htmlOptions->setPicturesCompression(PicturesCompression::Dpi150);

    $presentation->save("presentation-dpi-150.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

デフォルトでは、画像の切り抜き領域はエクスポート結果から削除されることがあります。ユーザーが隠れた画像部分を復元または検査できる必要がある場合にのみ切り抜きデータを保持してください。保持すると HTML のサイズが増加する可能性があります。

$presentation = new Presentation("presentation.pptx");
try {
    $htmlOptions = new HtmlOptions();
    $htmlOptions->setDeletePicturesCroppedAreas(false);

    $presentation->save("presentation-with-cropped-areas.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

CSS の追加

簡単なスタイリングの場合は、createDocumentFormatter を介して CSS 文字列を HtmlFormatter に渡します。これにより、Aspose.Slides がスライドコンテンツのレンダリングを続けながら、周囲の HTML ドキュメントが変更されます。

$presentation = new Presentation("presentation.pptx");
try {
    $cssRules = "body { margin: 0; background: #f7f7f7; } .slide { margin: 24px auto; }";
    $showSlideTitle = true;
    $formatter = java("com.aspose.slides.HtmlFormatter")->createDocumentFormatter($cssRules, $showSlideTitle);

    $htmlOptions = new HtmlOptions();
    $htmlOptions->setHtmlFormatter($formatter);

    $presentation->save("presentation-styled.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

カスタムドキュメントヘッダー、リンクされた CSS ファイル、またはスライドやシェイプ周辺のカスタムマークアップが必要な場合は、カスタムフォーマッティングコントローラーを使用し、createCustomFormatter で HtmlFormatter に渡します。

フォントの埋め込み

ターゲット環境にプレゼンテーションのフォントがインストールされていない可能性がある場合は、EmbedAllFontsHtmlController を使用して HTML にフォントを埋め込みます。埋め込むことで視覚的忠実度が向上しますが、出力サイズが増加します。

$presentation = new Presentation("presentation.pptx");
try {
    $arrayClass = new JavaClass("java.lang.reflect.Array");
    $stringClass = new JavaClass("java.lang.String");

    $fontNamesToExclude = $arrayClass->newInstance($stringClass, 1);
    $arrayClass->set($fontNamesToExclude, 0, new Java("java.lang.String", "Calibri"));

    $fontController = new EmbedAllFontsHtmlController(java_values($fontNamesToExclude));
    $formatter = java("com.aspose.slides.HtmlFormatter")->createCustomFormatter($fontController);

    $htmlOptions = new HtmlOptions();
    $htmlOptions->setHtmlFormatter($formatter);

    $presentation->save("presentation-embedded-fonts.html", SaveFormat::Html, $htmlOptions);
} finally {
    $presentation->dispose();
}

ターゲットのブラウザーやシステムが既にフォントを提供していると確信できる場合にのみ、フォントを除外してください。ブランドフォントやあまり一般的でないフォントについては、埋め込みが通常安全です。

フォントファイルをリンクして埋め込みを回避する

HTML ファイルサイズを削減するために、フォントデータを別々の WOFF ファイルに書き出し、HTML に @font-face ルールを追加できます。PHP via Java では、このシナリオは通常、EmbedAllFontsHtmlController を拡張した小さな Java ヘルパークラスで実装され、フォントバイトを出力ディレクトリに書き込み、生成された HTML に @font-face ルールを注入します。そのヘルパーをコンパイルし、PHP Java Bridge のクラスパスに追加し、PHP から new Java(...) でインスタンス化します。

そのようなヘルパーを作成する際は、意図的に 2 つのパスを選択してください：

ファイルシステムの出力パス：生成されたフォントファイルが書き込まれる場所。
URL パス：ブラウザーが HTML ドキュメントからフォントファイルを読み込む際に使用するパス。

リソースを外部に保存する

自己完結型 HTML は移動が容易ですが、埋め込まれた Base64 リソースによりファイルが大きくなることがあります。アプリケーションで外部画像ファイルが必要な場合は、HtmlOptions のコンストラクタにカスタムリンク/埋め込みコントローラーを提供します。

リソースを外部化する際は、意図的に 2 つのパスを選択してください：

ファイルシステムの出力パス：アプリケーションが生成した画像、フォント、音声、または動画を書き込む場所。
URL パス：ブラウザーが HTML ドキュメントからそれらのファイルを読み込む際に使用するパス。

これらのパスをデプロイメントレイアウトと一致させておくことで、生成された HTML がウェブサーバーや別のディレクトリに移動された後でも外部リソースを正しく読み込めます。

メディアファイルのエクスポート

VideoPlayerHtmlController はビデオとオーディオファイルをエクスポートし、ブラウザーで再生できる HTML を生成します。そのコンストラクタは以下を受け取ります：

path: 生成された HTML とメディアファイルが使用する出力ディレクトリ。
fileName: 生成中の HTML ファイル名。
baseUri: メディアファイルへの HTML リンクで使用される絶対 URI プレフィックス。

HTML ファイルが html-output/presentation.html の場合、path は html-output を指し、baseUri はブラウザーから見た同じディレクトリを指す必要があります。ローカルプレビューの場合は、出力ディレクトリから file:/// URI を作成できます。デプロイされたアプリケーションでは、公開された出力ディレクトリの絶対 URL を使用してください。

$outputDirectory = getcwd() . DIRECTORY_SEPARATOR . "html-output";

if (!is_dir($outputDirectory)) {
    mkdir($outputDirectory, 0777, true);
}

$htmlFileName = "presentation.html";
$outputDirectoryPath = realpath($outputDirectory);
$outputDirectoryPath = str_replace("\\", "/", $outputDirectoryPath);
$outputBaseUri = "file:///" . ltrim($outputDirectoryPath, "/") . "/";

$presentation = new Presentation();
$videoStream = null;
try {
    $videoFilePath = getcwd() . DIRECTORY_SEPARATOR . "intro.mp4";
    $videoStream = new Java("java.io.FileInputStream", $videoFilePath);
    $video = $presentation->getVideos()->addVideo($videoStream, LoadingStreamBehavior::ReadStreamAndRelease);
    $slide = $presentation->getSlides()->get_Item(0);
    $slide->getShapes()->addVideoFrame(20, 20, 480, 270, $video);

    $controller = new VideoPlayerHtmlController($outputDirectory, $htmlFileName, $outputBaseUri);
    $formatter = java("com.aspose.slides.HtmlFormatter")->createCustomFormatter($controller);
    $svgOptions = new SVGOptions($controller);
    $slideImageFormat = SlideImageFormat::svg($svgOptions);

    $htmlOptions = new HtmlOptions($controller);
    $htmlOptions->setHtmlFormatter($formatter);
    $htmlOptions->setSlideImageFormat($slideImageFormat);

    $htmlFilePath = $outputDirectory . DIRECTORY_SEPARATOR . $htmlFileName;
    $presentation->save($htmlFilePath, SaveFormat::Html, $htmlOptions);
} finally {
    if ($videoStream !== null) {
        $videoStream->close();
    }

    $presentation->dispose();
}

特にサーバーアプリケーションでは、エクスポートジョブごとに固有の出力ディレクトリを使用してください。共有出力パスを使用すると、異なる変換からのファイルが相互に上書きされる可能性があります。

パフォーマンスとリソース管理

HTML 変換はレンダリング操作であるため、処理時間とメモリ使用量はスライド数、画像解像度、フォント、エフェクト、チャート、埋め込みメディアに依存します。PicturesCompression の DPI 値を高くしたり、フォントを埋め込んだり、SVG 出力や切り抜き画像領域を保持したりすると忠実度が向上しますが、通常は出力サイズが増加します。

バッチ変換の場合：

Presentation インスタンスは速やかに破棄してください。
ジョブごとに別々の出力ディレクトリを使用してください。
忠実度が必要でない限り、一般的なフォントの埋め込みは避けてください。
HTML がプレビューやサムネイル用の場合は、画像 DPI を下げてください。
デプロイパスが最終決定になるまで、ソースプレゼンテーション、生成された HTML、外部リソースを一緒に保管してください。

FAQ

HTML 出力でハイパーリンクは保持されますか？

はい。プレゼンテーションのハイパーリンクは HTML にエクスポートされ、対象 URL が有効な場合はクリック可能なままです。

プレゼンテーションを並行して HTML に変換できますか？

はい、可能ですが、スレッド間で単一の Presentation インスタンスを共有しないでください。別々のプレゼンテーションインスタンス、別々のストリーム、別々の出力ディレクトリで異なるファイルを処理してください。

Presentation オブジェクトはスレッドセーフですか？

いいえ。単一の Presentation インスタンスは 1 つのスレッドで読み込み、変更、保存、破棄するべきです。並列処理を行う場合は、スレッドまたはプロセスごとに独立したインスタンスを作成してください。

生成された HTML ファイルが大きいのはなぜですか？

デフォルトのエクスポートではリソースが HTML に直接埋め込まれます。埋め込みフォント、高 DPI 画像、メディア、SVG コンテンツ、切り抜き画像領域の保持もサイズを増加させます。サイズを小さくしたい場合は外部リソースを使用し、一般的なフォントの埋め込みを除外し、PicturesCompression を下げてください。

メディアエクスポートの baseUri はどのように選択すべきですか？

baseUri はブラウザーから見た視点で選択し、絶対 URI として渡してください。ローカルプレビューの場合は、Java のファイル URI を使用して出力ディレクトリから導出できます。デプロイ時は、公開されたメディアディレクトリの絶対 URL を使用します。ファイルシステムの path とブラウザーの baseUri は同じ文字列である必要はありませんが、同じリソース位置を指し示す必要があります。

非表示スライドを含めることはできますか？

はい。非表示スライドをエクスポートする必要がある場合は、HtmlOptions の ShowHiddenSlides を true に設定してください。

PPTX を PHP で PPT に変換 PHP で PPT と PPTX を PDF に変換 [高度な機能を含む]