Mengonversi Presentasi PowerPoint ke HTML dengan Python

Overview

Aspose.Slides untuk Python via .NET dapat menyimpan presentasi PowerPoint sebagai HTML tanpa Microsoft PowerPoint. Konversi dasar adalah memuat satu Presentation dan memanggil save dengan SaveFormat. Gunakan HtmlOptions ketika Anda perlu mengontrol tata letak, font, gambar, catatan, komentar, output SVG, atau sumber daya yang ditautkan.

Panduan ini berfokus pada skenario ekspor HTML yang praktis:

  • Ekspor seluruh presentasi atau slide yang dipilih.
  • Hasilkan HTML dengan tata letak tetap, responsif, atau berbasis SVG.
  • Sertakan catatan pembicara dan komentar.
  • Kontrol kualitas gambar dan data gambar yang dipangkas.
  • Sematkan font atau simpan file font secara terpisah.
  • Pilih cara sumber daya eksternal dan file media ditulis dan direferensikan.

Secara default, ekspor HTML menghasilkan dokumen HTML yang mandiri di mana sebagian besar sumber daya disematkan. Ini memudahkan berbagi satu file, tetapi dapat meningkatkan ukuran output. Untuk penerbitan web, pertimbangkan sumber daya eksternal, menurunkan DPI gambar, dan hanya menyematkan font yang tidak tersedia secara andal di lingkungan target.

Convert a Presentation to HTML

Untuk mengekspor sebuah presentasi ke HTML, muat dengan Presentation dan simpan dengan SaveFormat.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    presentation.save("presentation.html", slides.export.SaveFormat.HTML)

Contoh ini menulis satu file HTML. Pernyataan with membuang objek presentation dan melepaskan handle file serta sumber daya rendering setelah ekspor.

Use HtmlOptions

HtmlOptions adalah kelas konfigurasi utama untuk ekspor HTML. Pengaturan umum meliputi:

  • slides_layout_options: menambahkan catatan, komentar, handout, atau informasi tata letak lainnya.
  • html_formatter: mengubah struktur dokumen HTML atau mendelegasikan pemformatan ke sebuah controller.
  • slide_image_format: mengubah cara slide direpresentasikan, misalnya sebagai SVG.
  • pictures_compression: mengontrol DPI gambar dan ukuran output.
  • delete_pictures_cropped_areas: mempertahankan atau menghapus data gambar yang dipangkas.
  • svg_responsive_layout: membuat konten SVG yang diekspor menyesuaikan dengan kontainer.
  • show_hidden_slides: menyertakan slide tersembunyi bila diperlukan.

Bagian berikut menunjukkan opsi paling umum secara terpisah sehingga Anda dapat menggabungkan hanya yang diperlukan oleh alur kerja Anda.

Convert Selected Slides to HTML

save overload yang menerima nomor slide menggunakan posisi slide berbasis 1. Loop di bawah menyimpan setiap slide ke file HTML terpisah.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    slide_count = len(presentation.slides)

    for slide_index in range(slide_count):
        slide_number = slide_index + 1
        slide_numbers = [slide_number]
        html_file_name = "slide-{}.html".format(slide_number)

        presentation.save(html_file_name, slide_numbers, slides.export.SaveFormat.HTML)

Gunakan pola ini ketika sebuah situs web atau aplikasi membutuhkan satu halaman HTML per slide. Jika setiap slide harus memiliki tata letak yang sama, buat satu instance HtmlOptions dan berikan ke setiap pemanggilan save.

Create Responsive HTML

ResponsiveHtmlController menyediakan output HTML responsif melalui HtmlFormatter. Gunakan ketika halaman yang diekspor harus lebih baik beradaptasi dengan lebar browser.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    controller = slides.export.ResponsiveHtmlController()
    formatter = slides.export.HtmlFormatter.create_custom_formatter(controller)

    html_options = slides.export.HtmlOptions()
    html_options.html_formatter = formatter

    presentation.save("presentation-responsive.html", slides.export.SaveFormat.HTML, html_options)

Untuk tata letak responsif berbasis SVG, atur svg_responsive_layout pada HtmlOptions. Ini berguna ketika konten slide diekspor sebagai markup SVG yang skalabel.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    html_options = slides.export.HtmlOptions()
    html_options.svg_responsive_layout = True

    presentation.save("presentation-svg-responsive.html", slides.export.SaveFormat.HTML, html_options)

Include Speaker Notes and Comments

Gunakan NotesCommentsLayoutingOptions melalui html_options.slides_layout_options untuk menyertakan catatan pembicara atau komentar. Catatan dan komentar disembunyikan secara default kecuali Anda memilih posisinya.

Misalkan presentasi sumber berisi catatan pembicara:

Slide with speaker notes in PowerPoint

Kode berikut mengekspor konten slide dengan catatan pembicara di bawah slide.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    layout_options = slides.export.NotesCommentsLayoutingOptions()
    layout_options.notes_position = slides.export.NotesPositions.BOTTOM_FULL

    html_options = slides.export.HtmlOptions()
    html_options.slides_layout_options = layout_options

    presentation.save("presentation-with-notes.html", slides.export.SaveFormat.HTML, html_options)

HTML yang diekspor menyertakan area catatan:

HTML output with the slide and speaker notes

Untuk mengekspor komentar, atur comments_position, misalnya ke CommentsPositions.RIGHT atau CommentsPositions.BOTTOM. Jika Anda hanya memerlukan komentar, hapus notes_position. Jika Anda memerlukan keduanya, atur kedua properti tersebut.

Control Image Quality and Cropped Areas

Ekspor HTML dapat mengompres gambar slide untuk mengurangi ukuran output. Atur pictures_compression ke nilai dari PicturesCompression ketika Anda memerlukan kualitas gambar yang lebih tinggi.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    html_options = slides.export.HtmlOptions()
    html_options.pictures_compression = slides.export.PicturesCompression.DPI150

    presentation.save("presentation-dpi-150.html", slides.export.SaveFormat.HTML, html_options)

Secara default, area yang dipangkas dari gambar dapat dihapus dari output yang diekspor. Simpan data yang dipangkas hanya ketika pengguna harus dapat memulihkan atau memeriksa bagian gambar yang tersembunyi tersebut. Menyimpannya dapat meningkatkan ukuran HTML.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    html_options = slides.export.HtmlOptions()
    html_options.delete_pictures_cropped_areas = False

    presentation.save("presentation-with-cropped-areas.html", slides.export.SaveFormat.HTML, html_options)

Add CSS

Untuk styling sederhana, berikan string CSS ke HtmlFormatter. Ini mengubah dokumen HTML di sekitarnya sementara Aspose.Slides tetap merender konten slide.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    css_rules = "body { margin: 0; background: #f7f7f7; } .slide { margin: 24px auto; }"
    formatter = slides.export.HtmlFormatter.create_document_formatter(css_rules, True)

    html_options = slides.export.HtmlOptions()
    html_options.html_formatter = formatter

    presentation.save("presentation-styled.html", slides.export.SaveFormat.HTML, html_options)

Untuk header dokumen khusus, file CSS yang ditautkan, atau markup khusus di sekitar slide dan shape, gunakan controller format khusus dan berikan ke HtmlFormatter dengan create_custom_formatter.

Embed Fonts

Jika lingkungan target mungkin tidak memiliki font presentasi yang terpasang, sematkan font dalam HTML dengan EmbedAllFontsHtmlController. Penyematan meningkatkan kesetiaan visual tetapi menambah ukuran output.

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
    font_names_to_exclude = ["Arial"]
    font_controller = slides.export.EmbedAllFontsHtmlController(font_names_to_exclude)
    formatter = slides.export.HtmlFormatter.create_custom_formatter(font_controller)

    html_options = slides.export.HtmlOptions()
    html_options.html_formatter = formatter

    presentation.save("presentation-embedded-fonts.html", slides.export.SaveFormat.HTML, html_options)

Kecualikan sebuah font hanya ketika Anda yakin bahwa peramban atau sistem target sudah menyediakan font tersebut. Untuk font merek atau font yang kurang umum, penyematan biasanya lebih aman.

Untuk mengurangi ukuran file HTML, Anda dapat menulis data font ke file WOFF terpisah dan menambahkan aturan @font-face ke HTML. Ini memerlukan controller yang menyesuaikan cara data font ditulis selama ekspor. Di Python via .NET, implementasikan controller tersebut dalam assembly helper .NET kecil, muat di Python, dan berikan objek helper ke HtmlFormatter dengan create_custom_formatter.

Saat Anda mengeksternalisasi font, pilih dua jalur dengan sengaja:

  • Direktori output sistem file tempat file WOFF yang dihasilkan akan ditulis.
  • Path URL yang akan muncul di dokumen HTML dan yang akan digunakan browser untuk memuat file font tersebut.

Simpan file HTML dan file font yang dihasilkan bersama sampai jalur penyebaran final. Jika file disebarkan ke lokasi lain, pastikan prefiks URL cocok dengan jalur URL yang disebarkan.

Save Resources Externally

HTML yang mandiri mudah dipindahkan, tetapi sumber daya Base64 yang disematkan dapat membuat file menjadi besar. Jika aplikasi Anda memerlukan file gambar, font, audio, atau video eksternal, gunakan controller link/embed khusus dan berikan ke konstruktor HtmlOptions.

Saat Anda mengeksternalisasi sumber daya, pilih dua jalur dengan sengaja:

  • Path output sistem file, tempat aplikasi Anda menulis gambar, font, audio, atau video yang dihasilkan.
  • Path URL, yaitu apa yang digunakan browser dari dokumen HTML untuk memuat file-file tersebut.

Untuk pembahasan lengkap tentang penautan gambar, lihat Export Presentations to HTML with Externally Linked Images.

Export Media Files

VideoPlayerHtmlController mengekspor file video dan audio serta menulis HTML yang dapat memainkannya di peramban. Konstruktornya menerima:

  • path: direktori tempat file media yang dihasilkan akan ditulis.
  • file_name: nama file HTML yang sedang dihasilkan.
  • base_uri: prefiks URI absolut yang digunakan dalam tautan HTML ke file media.

Jika file HTML adalah html-output/presentation.html dan file media disimpan di html-output/media, path harus mengacu ke direktori media di disk, sementara base_uri harus mengacu ke direktori yang sama dari perspektif peramban. Untuk pratinjau lokal, Anda dapat membangun URI file:/// dari direktori media. Untuk aplikasi yang disebarkan, gunakan URL absolut dari direktori media yang dipublikasikan.

import os
from pathlib import Path

import aspose.slides as slides

output_directory = os.path.join(os.getcwd(), "html-output")
media_directory = os.path.join(output_directory, "media")
os.makedirs(output_directory, exist_ok=True)
os.makedirs(media_directory, exist_ok=True)

html_file_name = "presentation.html"
media_base_uri = Path(media_directory).as_uri() + "/"

with slides.Presentation() as presentation:
    with open("intro.mp4", "rb") as video_stream:
        video = presentation.videos.add_video(
            video_stream,
            slides.LoadingStreamBehavior.READ_STREAM_AND_RELEASE)

    slide = presentation.slides[0]
    slide.shapes.add_video_frame(20, 20, 480, 270, video)

    controller = slides.export.VideoPlayerHtmlController(
        media_directory,
        html_file_name,
        media_base_uri)

    formatter = slides.export.HtmlFormatter.create_custom_formatter(controller)
    svg_options = slides.export.SVGOptions(controller)
    slide_image_format = slides.export.SlideImageFormat.svg(svg_options)

    html_options = slides.export.HtmlOptions(controller)
    html_options.html_formatter = formatter
    html_options.slide_image_format = slide_image_format

    html_file_path = os.path.join(output_directory, html_file_name)
    presentation.save(html_file_path, slides.export.SaveFormat.HTML, html_options)

Gunakan direktori output yang unik per pekerjaan ekspor, terutama pada aplikasi server. Path output yang dibagi dapat menyebabkan file dari konversi berbeda saling menimpa.

Performance and Resource Management

Konversi HTML adalah operasi rendering, sehingga waktu pemrosesan dan penggunaan memori bergantung pada jumlah slide, resolusi gambar, font, efek, diagram, dan media yang disematkan. Nilai DPI pictures_compression yang lebih tinggi, font yang disematkan, output SVG, dan area gambar yang dipangkas yang dipertahankan dapat meningkatkan kesetiaan tetapi biasanya menambah ukuran output.

Untuk konversi batch:

  • Segera dispose setiap instance Presentation .
  • Gunakan direktori output terpisah untuk pekerjaan yang terpisah.
  • Hindari menyematkan font umum kecuali diperlukan untuk kesetiaan.
  • Turunkan DPI gambar ketika HTML hanya untuk pratinjau atau thumbnail.
  • Simpan presentasi sumber, HTML yang dihasilkan, dan sumber daya eksternal bersama-sama hingga path penyebaran final.

FAQ

Are hyperlinks preserved in HTML output?
Apakah hyperlink dipertahankan dalam output HTML?
Ya. Hyperlink presentasi diekspor ke HTML dan tetap dapat diklik ketika URL target valid.

Can I convert presentations to HTML in parallel?
Bisakah saya mengonversi presentasi ke HTML secara paralel?
Ya, tetapi jangan berbagi satu instance Presentation di beberapa thread. Proses file yang berbeda dengan instance presentation terpisah, aliran terpisah, dan direktori output terpisah. Lihat multithreading guidance untuk detailnya.

Is a Presentation object thread-safe?
Apakah objek Presentation aman untuk thread?
Tidak. Satu instance Presentation harus dimuat, dimodifikasi, disimpan, dan di‑dispose pada satu thread. Untuk pekerjaan paralel, buat instance independen per thread atau proses.

Why is the generated HTML file large?
Mengapa file HTML yang dihasilkan besar?
Ekspor default dapat menyematkan sumber daya langsung ke HTML. Font yang disematkan, gambar DPI tinggi, media, konten SVG, dan area gambar yang dipangkas yang dipertahankan semuanya menambah ukuran. Gunakan sumber daya eksternal, kecualikan font umum dari penyematan, dan turunkan pictures_compression ketika keluaran yang lebih kecil lebih penting daripada kesetiaan maksimum.

Why does a PowerPoint font size such as 24 pt appear as 17.999819 pt in HTML?
Mengapa ukuran font PowerPoint seperti 24 pt muncul sebagai 17,999819 pt di HTML?
Hal ini dapat terjadi karena PowerPoint dan HTML menggunakan model DPI yang berbeda. PowerPoint menyimpan ukuran teks dalam poin tipografis berdasarkan 72 DPI, sementara tata letak HTML didasarkan pada piksel CSS dalam model 96 DPI. Saat Aspose.Slides mengekspor presentasi ke HTML, ukuran font diterjemahkan antara kedua sistem tersebut, dan konversi dapat memperkenalkan perbedaan pembulatan kecil. Nilai‑nilai ini tidak menunjukkan perubahan ukuran visual yang nyata; mereka hanyalah efek samping matematis dari konversi metrik teks antara PowerPoint dan HTML.

How should I choose base_uri for media export?
Bagaimana saya harus memilih base_uri untuk ekspor media?
Pilih base_uri dari perspektif peramban dan berikan sebagai URI absolut. Untuk pratinjau lokal, Anda dapat menurunkannya dari direktori output dengan Path(media_directory).as_uri() + "/". Untuk penyebaran, gunakan URL absolut dari direktori media yang dipublikasikan. Path sistem file path dan base_uri browser tidak harus berupa string yang sama, tetapi keduanya harus menggambarkan lokasi sumber daya yang sama.

Can I include hidden slides?
Bisakah saya menyertakan slide tersembunyi?
Ya. Atur show_hidden_slides = True pada HtmlOptions ketika slide tersembunyi harus diekspor.

Konversi PPTX ke PPT di Python Mengonversi PPT & PPTX ke PDF di Python | Opsi Lanjutan