تبدیل ارائه‌های PowerPoint به HTML در PHP

بررسی اجمالی

Aspose.Slides برای PHP از طریق Java می‌تواند ارائه‌های PowerPoint را به صورت HTML ذخیره کند بدون نیاز به Microsoft PowerPoint. تبدیل پایه شامل بارگذاری یک Presentation و فراخوانی save با SaveFormat است. از HtmlOptions وقتی نیاز به کنترل چیدمان خروجی، قلم‌ها، تصاویر، یادداشت‌ها، نظرات، خروجی SVG یا منابع پیوندی دارید، استفاده کنید.

این راهنما بر روی سناریوهای عملی صادرات HTML متمرکز است:

• صادرات کل ارائه یا اسلایدهای انتخاب‌شده.
• تولید HTML با چیدمان ثابت، واکنشگر یا مبتنی بر SVG.
• گنجاندن یادداشت‌های سخنران و نظرات.
• کنترل کیفیت تصویر و داده‌های تصویر برش‌خورده.
• درج قلم‌ها یا ذخیره جداگانه فایل‌های قلم.
• انتخاب نحوه نوشتن و ارجاع به منابع خارجی و فایل‌های رسانه‌ای.

به‌صورت پیش‌فرض، صادرات HTML یک سند HTML خودکفا تولید می‌کند که بیشتر منابع در آن جاسازی می‌شوند. این برای به‌اشتراک‌گذاری یک فایل راحت است، اما می‌تواند اندازه خروجی را افزایش دهد. برای انتشار وب، منابع خارجی، DPI تصویر کمتر و تنها درج قلم‌هایی که به‌صورت قابل اعتماد در محیط هدف موجود نیستند، در نظر بگیرید.

تبدیل یک ارائه به HTML

برای صادرات یک ارائه به HTML، آن را با Presentation بارگذاری کنید و با SaveFormat.Html ذخیره کنید.

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

این مثال یک فایل 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();
}

از این الگو زمانی استفاده کنید که یک وب‌سایت یا برنامه به یک صفحه HTML برای هر اسلاید نیاز دارد. اگر هر اسلاید باید همان چیدمان را داشته باشد، یک نمونه HtmlOptions ایجاد کنید و آن را به هر فراخوانی save منتقل کنید.

ایجاد HTML واکنشگر

ResponsiveHtmlController خروجی HTML واکنشگر را از طریق HtmlFormatter فراهم می‌کند. هنگامی که صفحه خروجی باید بهتر به عرض مرورگر سازگار شود، از آن استفاده کنید.

$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، SvgResponsiveLayout را روی HtmlOptions تنظیم کنید. این زمانی مفید است که محتوای اسلاید به صورت نشانه‌گذاری 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();
}

گنجاندن یادداشت‌های سخنران و نظرات

از NotesCommentsLayoutingOptions از طریق HtmlOptions.SlidesLayoutOptions برای گنجاندن یادداشت‌های سخنران یا نظرات استفاده کنید. یادداشت‌ها و نظرات به‌صورت پیش‌فرض مخفی هستند مگر آنکه موقعیت آن‌ها را انتخاب کنید.

فرض کنید ارائه منبع شامل یادداشت‌های سخنران باشد:

کد زیر محتوای اسلاید را به همراه یادداشت‌های سخنران زیر اسلاید صادر می‌کند.

$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 صادر شده شامل ناحیه یادداشت‌ها می‌شود:

برای صادرات نظرات، 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

برای استایل‌گذاری ساده، یک رشته CSS را به HtmlFormatter از طریق createDocumentFormatter پاس دهید. این سند HTML اطراف را تغییر می‌دهد در حالی که Aspose.Slides به رندر کردن محتوای اسلاید ادامه می‌دهد.

$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 پیوند شده یا نشانه‌گذاری سفارشی دور اسلایدها و شکل‌ها، از یک کنترلر قالب‌بندی سفارشی استفاده کنید و آن را به HtmlFormatter با createCustomFormatter پاس دهید.

درج قلم‌ها

اگر محیط هدف ممکن است قلم‌های استفاده‌شده در ارائه را نصب نکرده باشد، قلم‌ها را در HTML با EmbedAllFontsHtmlController درج کنید. درج کیفیت بصری را بهبود می‌بخشد اما اندازه خروجی را افزایش می‌دهد.

$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 جداگانه بنویسید و قوانین @font-face را به HTML اضافه کنید. در PHP از طریق Java این سناریو معمولاً با یک کلاس کمکی کوچک Java که از EmbedAllFontsHtmlController ارث می‌برد، داده‌های قلم را در یک پوشه خروجی می‌نویسد و قوانین @font-face را به HTML تولید شده تزریق می‌کند، پیاده‌سازی می‌شود. آن کلاس کمکی را کامپایل کنید، به مسیر کلاس‌های PHP Java Bridge اضافه کنید و سپس از PHP با new Java(...) نمونه‌سازی کنید.

هنگامی که چنین کمکی می‌سازید، دو مسیر را عمداً انتخاب کنید:

• مسیر خروجی سیستم‌فایل، که فایل‌های قلم تولید شده در آن نوشته می‌شوند.
• مسیر URL، که مرورگر از سند HTML برای بارگذاری آن فایل‌های قلم استفاده می‌کند.

ذخیره منابع به‌صورت خارجی

HTML خودکفا جابجایی آسان دارد، اما منابع Base64 جاسازی شده می‌تواند فایل را بزرگ کند. اگر برنامه شما به فایل‌های تصویر خارجی نیاز دارد، یک کنترلر لینک/درج سفارشی به سازنده HtmlOptions ارائه دهید.

وقتی منابع را به‌صورت خارجی می‌کنید، دو مسیر را عمداً انتخاب کنید:

• مسیر خروجی سیستم‌فایل، که برنامه شما تصاویر، قلم‌ها، صدا یا ویدئوهای تولید شده را در آن می‌نویسد.
• مسیر URL، که مرورگر از سند HTML برای بارگذاری آن فایل‌ها استفاده می‌کند.

این مسیرها را با چینش استقرار خود هماهنگ نگه دارید تا HTML تولید شده پس از انتقال به سرور وب یا پوشه دیگر بتواند منابع خارجی خود را بارگذاری کند.

صادرات فایل‌های رسانه‌ای

VideoPlayerHtmlController ویدئو و صدا را صادر می‌کند و HTMLی می‌نویسد که می‌تواند در مرورگر پخش شود. سازنده آن موارد زیر را می‌گیرد:

• path: پوشه خروجی که توسط HTML و فایل‌های رسانه‌ای تولید شده استفاده می‌شود.
• fileName: نام فایل HTML که در حال تولید است.
• baseUri: پیشوند URI مطلق که در لینک‌های HTML به فایل‌های رسانه‌ای استفاده می‌شود.

اگر فایل HTML html-output/presentation.html باشد، path باید به html-output اشاره کند و baseUri باید از دید مرورگر به همان پوشه اشاره کند. برای پیش‌نمایش محلی می‌توانید یک URI file:/// از پوشه خروجی بسازید. برای برنامه منتشرشده، از 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 یک عملیات رندر است، بنابراین زمان پردازش و مصرف حافظه به تعداد اسلایدها، وضوح تصویر، قلم‌ها، افکت‌ها، نمودارها و رسانه‌های جاسازی‌شده بستگی دارد. مقادیر DPI بالاتر PicturesCompression، قلم‌های جاسازی‌شده، خروجی SVG و نگه‌داشتن نواحی برش‌خورده می‌تواند دقت را افزایش دهد اما معمولاً اندازه خروجی را بزرگ می‌کند.

برای تبدیل دسته‌ای:

• به‌سرعت هر نمونه از Presentation را آزاد کنید.
• برای هر کار، پوشه خروجی جداگانه استفاده کنید.
• از درج قلم‌های عمومی خودداری کنید مگر اینکه دقت بالا ضروری باشد.
• DPI تصویر را هنگام استفاده برای پیش‌نمایش یا تصویرهای کوچک کاهش دهید.
• تا زمان نهایی شدن مسیرهای استقرار، ارائه منبع، HTML تولید شده و منابع خارجی را همراه هم نگه دارید.

FAQ

آیا پیوندهای هایپرلینک در خروجی HTML حفظ می‌شوند؟

بله. پیوندهای هایپرلینک ارائه به HTML صادر می‌شوند و زمانی که URL هدف معتبر باشد، قابل کلیک باقی می‌مانند.

آیا می‌توانم ارائه‌ها را به صورت همزمان به HTML تبدیل کنم؟

بله، اما یک نمونه Presentation را بین نخ‌ها به اشتراک نگذارید. فایل‌های مختلف را با نمونه‌های ارائه جداگانه، جریان‌های جداگانه و پوشه‌های خروجی جداگانه پردازش کنید.

آیا شیء Presentation ایمن برای استفاده در چندین نخ است؟

نه. یک نمونه واحد Presentation باید در یک نخ بارگذاری، اصلاح، ذخیره و آزاد شود. برای کار موازی، یک نمونه مستقل برای هر نخ یا فرآیند ایجاد کنید.

چرا فایل HTML تولید شده بزرگ است؟

صادرات پیش‌فرض می‌تواند منابع را مستقیماً در HTML جاسازی کند. قلم‌های جاسازی‌شده، تصاویر با DPI بالا، رسانه‌ها، محتوای SVG و نگه‌داشتن نواحی برش‌خورده تصویر نیز اندازه را افزایش می‌دهند. برای کاهش اندازه، از منابع خارجی استفاده کنید، قلم‌های رایج را از درج حذف کنید و PicturesCompression را هنگام نیاز به خروجی کوچکتر کاهش دهید.

چرا اندازه قلم در PowerPoint مانند 24 pt در HTML به 17.999819 pt تبدیل می‌شود؟

این می‌تواند به دلیل مدل‌های DPI متفاوت بین PowerPoint و HTML باشد. PowerPoint اندازه‌های متن را بر پایه نقاط تایپوگرافی با 72 DPI ذخیره می‌کند، در حالی که چیدمان HTML بر پایه پیکسل‌های CSS در مدل 96 DPI است. زمانی که Aspose.Slides ارائه را به HTML صادر می‌کند، اندازه قلم بین این سیستم‌ها ترجمه می‌شود و تبدیل ممکن است تفاوت‌های رند کردن کوچکی ایجاد کند.

این مقادیر نشان‌دهنده تغییر واقعی در اندازه ظاهری قلم نیستند؛ فقط اثر جانبی ریاضیاتی تبدیل معیارهای متن بین PowerPoint و HTML است.

چگونه باید baseUri را برای صادرات رسانه انتخاب کنم؟

baseUri را از دید مرورگر انتخاب کرده و به صورت URI مطلق پاس دهید. برای پیش‌نمایش محلی می‌توانید آن را از پوشه خروجی با یک URI فایل Java استخراج کنید. برای استقرار، از URL مطلق پوشه رسانه‌ای منتشر شده استفاده کنید. مسیر سیستم‌فایل path و baseUri مرورگر لازم نیست یک رشته یکسان باشند، اما باید به همان مکان منبع اشاره داشته باشند.

آیا می‌توانم اسلایدهای مخفی را شامل شوم؟

بله. وقتی اسلایدهای مخفی باید صادر شوند، ShowHiddenSlides را بر روی true در HtmlOptions تنظیم کنید.