وارد کردن ارائه‌ها از PDF یا HTML در Python از طریق Java

این صفحه درباره چیست

یاد بگیرید چگونه محتوای PDF و HTML را به ارائه‌های پاورپوینت در Python از طریق Java با Aspose.Slides وارد کنید و نتایج را به‌صورت فایل‌های PPTX ذخیره کنید.

معرفی

Aspose.Slides for Python via Java می‌تواند صفحات PDF یا محتوای HTML را بدون نیاز به Microsoft PowerPoint به اسلایدهای پاورپوینت تبدیل کند. کلاس SlideCollection متدهای addFromPdf و addFromHtml را برای افزودن محتوای وارد شده به یک ارائه فراهم می‌کند.

برای کنترل بیشتر بر مکان HTML، متد SlideCollection.insertFromHtml می‌تواند اسلایدهای تولید شده را در یک ایندکس مجموعه قرار دهد یا فضای موجود در اسلاید فعلی را پر کند. HTML طولانی به‌صورت خودکار در اسلایدهای اضافه صفحه‌بندی می‌شود، منبع می‌تواند به‌صورت رشته یا جریان ارائه شود، و منابع خارجی می‌توانند از طریق ExternalResourceResolver با یک URI پایه بارگذاری شوند. آرایهٔ بازگرداندهٔ Slide اسلایدهای تحت تأثیر و تازهٔ ایجادشده را شناسایی می‌کند.

وارد کردن از PDF

برای تبدیل یک سند PDF به ارائهٔ پاورپوینت، محتوای آن را به مجموعه اسلایدها وارد کنید و نتیجه را به‌عنوان فایل PPTX ذخیره نمایید.

1. یک شیء جدید از Presentation ایجاد کنید.
2. متد addFromPdf را با مسیر فایل PDF صدا بزنید.
3. متد save را با SaveFormat.Pptx فراخوانی کنید تا ارائه در یک فایل PPTX نوشته شود.

مثال پایتون زیر یک سند PDF را وارد کرده و اسلایدهای تولید شده را به‌عنوان ارائهٔ پاورپوینت ذخیره می‌کند:

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 اسلایدهایی را که اضافه می‌کند باز می‌گرداند؛ این برای پردازش فقط اسلایدهای وارد شده مفید است.

Tip

سعی کنید از برنامهٔ وب رایگان PDF to PowerPoint برای مشاهدهٔ این گردش کار تبدیل استفاده کنید.

وارد کردن از HTML

Aspose.Slides همچنین می‌تواند اسلایدها را از یک سند HTML ایجاد کند. منبع می‌تواند به‌صورت متن HTML یا جریان ارائه شود. مراحل زیر از یک جریان فایل استفاده می‌کند:

1. یک شیء جدید از Presentation ایجاد کنید.
2. فایل HTML را برای خواندن باز کنید و جریان را به addFromHtml پاس دهید.
3. متد save را با SaveFormat.Pptx فراخوانی کنید تا نتیجه در یک فایل PPTX نوشته شود.

مثال پایتون زیر یک سند HTML را وارد کرده و اسلایدهای تولید شده را به‌عنوان ارائهٔ پاورپوینت ذخیره می‌کند:

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

از SlideCollection.insertFromHtml استفاده کنید زمانی که اسلایدهای تولید شده از HTML باید در موقعیتی خاص قرار گیرند نه اینکه به‌صورت پیوسته اضافه شوند. ایندکس صفر مبنا است و موقعیتی را که وارد کردن از آن شروع می‌شود تعیین می‌کند.

پارامتر 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()

Warning

یک حل‌کنندهٔ منبع خارجی بدون محدودیت می‌تواند منابع محلی یا شبکه‌ای اشاره شده در HTML را بخواند. برای ورودی‌های غیرقابل اعتماد، قبل از وارد کردن HTML، URLهای منابع را بر اساس لیست سفید از طرح‌واره‌ها، دایرکتوری‌ها و میزبان‌های مجاز اعتبارسنجی و پاک‌سازی کنید.

سؤالات متداول

آیا Aspose.Slides می‌تواند جدول‌ها را هنگام وارد کردن PDF تشخیص دهد؟

بله. یک شیء PdfImportOptions ایجاد کنید، متد setDetectTables را با True فراخوانی کنید و گزینه‌ها را به addFromPdf پاس دهید. کیفیت شناسایی جدول‌ها به ساختار و پیچیدگی PDF منبع بستگی دارد.

Note

پس از وارد کردن HTML، می‌توانید اسلایدها را به images، TIFF، یا SVG نیز صادر کنید.