在 Python via Java 中從 PDF 或 HTML 匯入簡報

本頁內容簡介

了解如何使用 Aspose.Slides 在 Python via Java 中將 PDF 與 HTML 內容匯入 PowerPoint 簡報，並將結果儲存為 PPTX 檔案。

簡介

Aspose.Slides for Python via Java 可以在不使用 Microsoft PowerPoint 的情況下，將 PDF 頁面或 HTML 內容轉換為 PowerPoint 投影片。 SlideCollection 類別提供 addFromPdf 和 addFromHtml 以將匯入的內容附加到簡報中。

若需更細緻的 HTML 位置控制， SlideCollection.insertFromHtml 可在集合索引處插入產生的投影片，或在現有投影片上開始填充可用空間。過長的 HTML 會自動分頁至其他投影片，來源可以以字串或串流提供，且可透過 ExternalResourceResolver 並搭配基礎 URI 來載入外部資源。回傳的 Slide 陣列會標示受影響的投影片與新建立的投影片。

從 PDF 匯入

要將 PDF 文件轉換為 PowerPoint 簡報，請將其內容匯入投影片集合，並將結果儲存為 PPTX 檔案。

pdf-to-powerpoint

建立一個新的 Presentation 物件。
使用 PDF 檔案路徑呼叫 addFromPdf。
使用 SaveFormat.Pptx 呼叫 save ，將簡報寫入 PPTX 檔案。

以下 Python 範例會匯入 PDF 文件，並將產生的投影片儲存為 PowerPoint 簡報：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    presentation.getSlides().addFromPdf("document.pdf")
    presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

預設的空白投影片會留在簡報中，因為匯入會在最後附加投影片。若只想保留匯入的頁面，請在匯入前使用 SlideCollection.clear 清除投影片集合。

addFromPdf 方法會回傳它所新增的投影片，當您只需處理匯入的投影片時非常有用。

提示

試用免費的 PDF to PowerPoint 網路應用程式，親自體驗此轉換工作流程。

從 HTML 匯入

Aspose.Slides 也能從 HTML 文件建立投影片。來源可以以 HTML 文字或串流提供。以下步驟使用檔案串流：

建立一個新的 Presentation 物件。
開啟 HTML 檔案以讀取，並將串流傳遞給 addFromHtml。
使用 SaveFormat.Pptx 呼叫 save ，將結果寫入 PPTX 檔案。

以下 Python 範例會匯入 HTML 文件，並將產生的投影片儲存為 PowerPoint 簡報：

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat
from java.io import FileInputStream

presentation = Presentation()
try:
    html_stream = FileInputStream("page.html")
    try:
        presentation.getSlides().addFromHtml(html_stream)
    finally:
        html_stream.close()
    presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

插入 HTML 內容

當必須將 HTML 產生的投影片放置於特定位置而非附加時，請使用 SlideCollection.insertFromHtml。索引採用零基制，表示匯入開始的位置。

useSlideWithIndexAsStart 參數控制匯入程式如何使用該位置：

當其為 False 時，匯入程式會在指定索引處建立新投影片，並將其後的投影片向後移動。
當其為 True 時，匯入程式會在該索引的現有投影片的可用空間中開始放置內容。若 HTML 無法容納，Aspose.Slides 會自動分頁，並在起始投影片之後立即插入額外投影片。

SlideCollection.insertFromHtml 會回傳一個 Slide 物件陣列。若插入在新投影片上開始，則每個回傳項目皆為新建立的投影片。若使用現有投影片作為起點，陣列會包含受影響的那張投影片，然後是任何新產生的溢位投影片。您可以檢查此陣列，而不必根據簡報的投影片數量計算受影響的範圍。

將 HTML 插入為新投影片

以下範例以字串提供 HTML，並在集合索引 1 處插入產生的投影片。傳入 False 會保留現有投影片不變，僅將其向後移動以騰出空間。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    layout_slide = presentation.getLayoutSlides().get_Item(0)
    presentation.getSlides().addEmptySlide(layout_slide)
    presentation.getSlides().addEmptySlide(layout_slide)

    insert_index = 1
    html = "<html><body><h1>Quarterly update</h1><p>This content is inserted before the slide that was at index 1.</p></body></html>"
    inserted_slides = presentation.getSlides().insertFromHtml(insert_index, html, False)

    for slide in inserted_slides:
        print("Inserted slide index:", presentation.getSlides().indexOf(slide))

    presentation.save("presentation-with-inserted-html.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

在現有投影片上開始

以下範例透過串流提供 HTML。它保留現有模板投影片上的標題形狀，從已占用區域下方開始匯入，並讓較長的內文持續到新投影片。

HTML 亦包含相對圖像 URL。透過 ExternalResourceResolver 可取得資源，而基礎 URI 告訴匯入程式如何解析 images/logo.png。在此範例中，該檔案預期位於 html-assets/images/logo.png。

from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExternalResourceResolver, Presentation, SaveFormat, ShapeType
from java.io import ByteArrayInputStream

presentation = Presentation()
try:
    template_slide = presentation.getSlides().get_Item(0)
    header = template_slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 680, 60)
    header.getTextFrame().setText("Product roadmap")

    html_parts = ["<html><body><img src='images/logo.png' width='120' height='60'><h2>Roadmap details</h2>"]
    for item_index in range(1, 61):
        html_parts.append(f"<p style='font-size:24pt'>Roadmap item {item_index}: detailed implementation notes.</p>")
    html_parts.append("</body></html>")

    html = "".join(html_parts)
    html_data = html.encode("utf-8")
    resolver = ExternalResourceResolver()
    base_directory = Path("html-assets").resolve()
    base_uri = base_directory.as_uri() + "/"

    html_stream = ByteArrayInputStream(html_data)
    try:
        affected_slides = presentation.getSlides().insertFromHtml(0, html_stream, resolver, base_uri, True)
        for slide in affected_slides:
            print("Affected slide index:", presentation.getSlides().indexOf(slide))
    finally:
        html_stream.close()

    presentation.save("presentation-with-html-overflow.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

警告

未受限制的外部資源解析器可能會讀取 HTML 中引用的本機或網路資源。對於不可信的輸入，請在匯入 HTML 前，根據允許的方案、目錄與主機清單驗證並淨化資源 URL。

常見問題

當匯入 PDF 時，Aspose.Slides 能偵測表格嗎？

可以。建立一個 PdfImportOptions 物件，使用 True 呼叫 setDetectTables，並將此選項傳遞給 addFromPdf。表格偵測的品質取決於來源 PDF 的結構與複雜度。

注意

匯入 HTML 後，您也可以將投影片匯出為 images、TIFF 或 SVG。

在 Python via Java 中的低程式碼簡報操作使用 Python 轉換簡報為多種格式