PowerPoint Sunumlarını PHP'de HTML'ye Dönüştür

Genel Bakış

Aspose.Slides for PHP via Java, Microsoft PowerPoint olmadan PowerPoint sunumlarını HTML olarak kaydedebilir. Temel dönüşüm, tek bir Presentation yüklemesi ve SaveFormat ile bir save çağrısıdır. Dışa aktarılan düzeni, yazı tiplerini, resimleri, notları, yorumları, SVG çıktısını veya bağlı kaynakları kontrol etmeniz gerektiğinde HtmlOptions kullanın.

Bu kılavuz, pratik HTML dışa aktarım senaryolarına odaklanır:

• Tüm bir sunumu veya seçilmiş slaytları dışa aktar.
• Sabit düzenli, duyarlı veya SVG tabanlı HTML oluştur.
• Konuşmacı notlarını ve yorumları dahil et.
• Görüntü kalitesini ve kırpılmış görüntü verilerini kontrol et.
• Yazı tiplerini göm veya yazı tipi dosyalarını ayrı kaydet.
• Harici kaynakların ve medya dosyalarının nasıl yazılacağını ve başvurulacağını seç.

Varsayılan olarak, HTML dışa aktarımı, çoğu kaynağın gömülü olduğu bağımsız bir HTML belgesi üretir. Tek bir dosya paylaşmak için bu uygundur, ancak çıktı boyutunu artırabilir. Web yayıncılığı için harici kaynakları, daha düşük görüntü DPI’sını ve hedef ortamda güvenilir şekilde bulunmayan yazı tiplerini yalnızca gömmeyi değerlendirin.

Bir Sunumu HTML’ye Dönüştürme

Bir sunumu HTML’ye dışa aktarmak için, onu Presentation ile yükleyin ve SaveFormat.Html ile kaydedin.

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

Bu örnek bir HTML dosyası yazar. Sunum nesnesi, dışa aktarmadan sonra dosya tutucuları ve render kaynaklarını serbest bırakan finally bloğunda yok edilir.

HtmlOptions Kullanımı

HtmlOptions HTML dışa aktarımı için ana yapılandırma sınıfıdır. Yaygın ayarlar şunları içerir:

• SlidesLayoutOptions: notlar, yorumlar, el kitapçıkları veya diğer düzen bilgilerini ekler.
• HtmlFormatter: HTML belge yapısını değiştirir veya biçimlendirmeyi bir denetleyiciye devreder.
• SlideImageFormat: slaytların nasıl temsil edileceğini değiştirir, örneğin SVG olarak.
• PicturesCompression: görüntü DPI’sını ve çıktı boyutunu kontrol eder.
• DeletePicturesCroppedAreas: kırpılmış görüntü verilerini tutar veya kaldırır.
• SvgResponsiveLayout: dışa aktarılan SVG içeriğinin kapsayıcısına uyum sağlamasını sağlar.
• ShowHiddenSlides: gerektiğinde gizli slaytları dahil eder.

Aşağıdaki bölümler en yaygın seçenekleri ayrı ayrı gösterir, böylece iş akışınızın gerektirdiği yalnızca gerekli seçenekleri birleştirebilirsiniz.

Seçili Slaytları HTML’ye Dönüştürme

Slayt numaralarını kabul eden save aşırı yüklemesi 1 tabanlı slayt konumlarını kullanır. Aşağıdaki döngü her slaytı ayrı bir HTML dosyasına kaydeder.

$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();
}

Bir web sitesi veya uygulamanın slayt başına bir HTML sayfasına ihtiyacı olduğunda bu deseni kullanın. Her slayt aynı düzene sahip olmalıysa bir HtmlOptions örneği oluşturun ve her save çağrısına geçirin.

Duyarlı HTML Oluşturma

ResponsiveHtmlController HtmlFormatter aracılığıyla duyarlı HTML çıktısı sağlar. Dışa aktarılan sayfanın tarayıcı genişliğine daha iyi uyum sağlaması gerektiğinde bunu kullanın.

$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 tabanlı duyarlı düzen için, HtmlOptions üzerinde SvgResponsiveLayout ayarlayın. Bu, slayt içeriği ölçeklenebilir SVG işaretlemesi olarak dışa aktarıldığında faydalıdır.

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

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

Konuşmacı Notları ve Yorumları Dahil Etme

Konuşmacı notlarını veya yorumları eklemek için HtmlOptions.SlidesLayoutOptions aracılığıyla NotesCommentsLayoutingOptions kullanın. Notlar ve yorumlar varsayılan olarak gizlidir; konumlarını seçmediğiniz sürece görünmez.

Kaynak sunumun konuşmacı notları içerdiğini varsayalım:

Aşağıdaki kod, slayt içeriğini slaytın altında konuşmacı notlarıyla dışa aktarır.

$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();
}

Yorumları dışa aktarmak için CommentsPosition ayarlayın, örneğin CommentsPositions.Right veya CommentsPositions.Bottom. Yalnızca yorumlara ihtiyacınız varsa NotesPosition özelliğini atlayın. Hem notları hem de yorumları istiyorsanız her iki özelliği de ayarlayın.

Görüntü Kalitesini ve Kırpılmış Alanları Kontrol Etme

HTML dışa aktarımı, çıktı boyutunu azaltmak için slayt görüntülerini sıkıştırabilir. Daha yüksek görüntü kalitesine ihtiyacınız olduğunda PicturesCompression değerini PicturesCompression‘den bir değerle ayarlayın.

$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();
}

Varsayılan olarak, görüntülerin kırpılmış alanları dışa aktarılan çıktıda kaldırılabilir. Kullanıcıların bu gizli görüntü parçalarını geri getirebilmesi veya inceleyebilmesi gerektiğinde kırpılmış verileri tutun. Tutmak HTML boyutunu artırabilir.

$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 Ekleme

Basit stillendirme için, createDocumentFormatter aracılığıyla bir CSS dizesini HtmlFormatter’a geçirin. Bu, Aspose.Slides slayt içeriğini render etmeye devam ederken çevredeki HTML belgesini değiştirir.

$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();
}

Özel bir belge başlığı, bağlanmış bir CSS dosyası veya slaytlar ve şekiller etrafında özel işaretleme için, özel bir biçimlendirme denetleyicisi kullanın ve bunu createCustomFormatter ile HtmlFormatter’a geçirin.

Yazı Tiplerini Gömme

Hedef ortam sunum yazı tiplerini kurulu olmayabileceği durumlarda, EmbedAllFontsHtmlController ile yazı tiplerini HTML’ye gömün. Gömme görsel sadakati artırır ancak çıktı boyutunu büyütür.

$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();
}

Yazı tiplerini yalnızca hedef tarayıcıların veya sistemlerin zaten sağladığından emin olduğunuzda dışarıda bırakın. Marka yazı tipleri veya daha az yaygın yazı tipleri için gömme genellikle daha güvenlidir.

Yazı Tipi Dosyalarını Gömmek Yerine Bağlantı Verme

HTML dosya boyutunu azaltmak için, yazı tipi verilerini ayrı WOFF dosyalarına yazabilir ve HTML’ye @font-face kuralları ekleyebilirsiniz. PHP via Java’da bu senaryo genellikle EmbedAllFontsHtmlController’ı genişleten küçük bir Java yardımcı sınıfı ile uygulanır; bu sınıf yazı tipi baytlarını bir çıktı dizinine yazar ve oluşturulan HTML’ye @font-face kurallarını ekler. Bu yardımcı sınıfı derleyin, PHP Java Bridge sınıf yoluna ekleyin ve ardından PHP’den new Java(...) ile örnekleyin.

Bu tür bir yardımcı oluştururken iki yolu bilinçli olarak seçin:

• Dosya sistemi çıktı yolu, oluşturulan yazı tipi dosyalarının yazıldığı yer.
• URL yolu, tarayıcının HTML belgesinden bu yazı tipi dosyalarını yüklemek için kullandığı yol.

Kaynakları Harici Olarak Kaydetme

Bağımsız HTML taşımak kolaydır, ancak gömülü Base64 kaynaklar dosyayı büyük yapabilir. Uygulamanız harici resim dosyalarına ihtiyaç duyuyorsa, HtmlOptions yapıcıya özel bir bağlantı/gömme denetleyicisi sağlayın.

Kaynakları harici hale getirirken iki yolu bilinçli olarak seçin:

• Dosya sistemi çıktı yolu, uygulamanızın oluşturulan görüntü, yazı tipi, ses veya video dosyalarını yazdığı yer.
• URL yolu, tarayıcının HTML belgesinden bu dosyaları yüklemek için kullandığı yol.

Bu yolları dağıtım yapınıza uygun tutun, böylece oluşturulan HTML bir web sunucusuna veya başka bir dizine taşındıktan sonra harici kaynaklarını yükleyebilir.

Medya Dosyalarını Dışa Aktarma

VideoPlayerHtmlController video ve ses dosyalarını dışa aktarır ve tarayıcıda oynatabilecek HTML yazar. Yapıcısı şunları alır:

• path: oluşturulan HTML ve medya dosyaları için kullanılan çıktı dizini.
• fileName: oluşturulan HTML dosyasının adı.
• baseUri: medya dosyalarına HTML bağlantılarında kullanılan mutlak URI öneki.

HTML dosyası html-output/presentation.html ise, path html-output dizinine işaret etmeli ve baseUri tarayıcının bakış açısından aynı dizine işaret etmelidir. Yerel önizleme için, çıktı dizininden bir file:/// URI’si oluşturabilirsiniz. Dağıtılmış bir uygulama için, yayınlanmış çıktı dizininin mutlak URL’sini kullanın.

$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();
}

İhracat işi başına benzersiz çıktı dizinleri kullanın, özellikle sunucu uygulamalarında. Paylaşılan çıktı yolları farklı dönüşümlerin dosyalarının birbirinin üzerine yazılmasına neden olabilir.

Performans ve Kaynak Yönetimi

HTML dönüşümü bir renderleme işlemidir, bu nedenle işleme süresi ve bellek kullanımı slayt sayısına, görüntü çözünürlüğüne, yazı tiplerine, efektlere, grafiklere ve gömülü medyaya bağlıdır. Daha yüksek PicturesCompression DPI değerleri, gömülü yazı tipleri, SVG çıktısı ve tutulan kırpılmış görüntü alanları sadakati artırabilir ancak genellikle çıktı boyutunu büyütür.

Toplu dönüşüm için:

• Her Presentation örneğini hızlıca yok edin.
• Farklı işler için ayrı çıktı dizinleri kullanın.
• Sadakat gerektirmiyorsa yaygın yazı tiplerini gömmekten kaçının.
• HTML önizleme veya küçük resimler için görüntü DPI’sını düşürün.
• Kaynak sunumu, oluşturulan HTML ve harici kaynakları dağıtım yolları kesinleşene kadar bir arada tutun.

SSS

HTML çıktısında köprüler korunuyor mu?

Evet. Sunum köprüleri HTML’ye dışa aktarılır ve hedef URL geçerli olduğunda tıklanabilir kalır.

Sunumları paralel olarak HTML’ye dönüştürebilir miyim?

Evet, ancak bir Presentation örneğini farklı iş parçacıkları arasında paylaşmayın. Farklı dosyaları ayrı sunum örnekleri, ayrı akışlar ve ayrı çıktı dizinleriyle işleyin.

Presentation nesnesi iş parçacığı güvenli mi?

Hayır. Tek bir Presentation örneği bir iş parçacığında yüklenmeli, değiştirilmeli, kaydedilmeli ve yok edilmelidir. Paralel çalışmalarda, iş parçacığı başına bağımsız bir örnek oluşturun.

Oluşturulan HTML dosyası neden büyük?

Varsayılan dışa aktarım kaynakları doğrudan HTML’ye gömebilir. Gömülü yazı tipleri, yüksek DPI’li görüntüler, medya, SVG içeriği ve tutulan kırpılmış görüntü alanları da boyutu artırır. Daha küçük çıktı, en yüksek sadakatten daha önemliyse harici kaynaklar kullanın, yaygın yazı tiplerini gömmekten çıkarın ve PicturesCompression değerini düşürün.

Neden PowerPoint’te 24 pt gibi bir yazı tipi boyutu HTML’de 17.999819 pt olarak görülüyor?

Bu, PowerPoint ve HTML’nin farklı DPI modelleri kullanmasından kaynaklanabilir. PowerPoint, metin boyutlarını 72 DPI’ye dayalı tipografik puanlarla saklarken, HTML yerleşimi 96 DPI modeline dayalı CSS piksellerine dayanır. Aspose.Slides bir sunumu HTML’ye dışa aktardığında, yazı tipi boyutu bu sistemler arasında çevrilir ve dönüşüm küçük yuvarlama farkları oluşturabilir.

Bu değerler gerçek bir görsel yazı tipi boyutu değişikliğini göstermez. Bunlar yalnızca PowerPoint ve HTML arasında metin ölçüleri dönüştürülürken ortaya çıkan matematiksel bir yan etkidir.

Medya dışa aktarımı için baseUri nasıl seçilmeli?

baseUri‘yi tarayıcının bakış açısından seçin ve mutlak bir URI olarak gönderin. Yerel önizleme için, çıktı dizininden bir Java dosya URI’si türetebilirsiniz. Dağıtım için yayınlanan medya dizininin mutlak URL’sini kullanın. Dosya sistemi path ve tarayıcı baseUri aynı dize olmak zorunda değildir, ancak aynı kaynak konumunu tanımlamalıdır.

Gizli slaytları dahil edebilir miyim?

Evet. Gizli slaytların dışa aktarılması gerektiğinde HtmlOptions üzerinde ShowHiddenSlides değerini true olarak ayarlayın.