تبدیل ارائههای PowerPoint به HTML در Python از طریق Java
بررسی کلی
Aspose.Slides for Python via Java میتواند ارائههای PowerPoint را بدون نیاز به Microsoft PowerPoint به HTML ذخیره کند. تبدیل پایه شامل یک بارگذاری Presentation و یک فراخوانی save با استفاده از SaveFormat است. وقتی نیاز به کنترل طرح خروجی، فونتها، تصاویر، یادداشتها، نظرات، خروجی SVG یا منابع مرتبط دارید، از HtmlOptions استفاده کنید.
این راهنما بر سناریوهای عملی صادرات HTML تمرکز دارد:
- صادرات کل ارائه یا اسلایدهای انتخابی.
- تولید HTML با طرح ثابت، واکنشگرا یا مبتنی بر SVG.
- گنجاندن یادداشتهای سخنران و نظرات.
- کنترل کیفیت تصویر و دادههای تصاویر برشخورده.
- تعبیه فونتها یا ذخیرهٔ فایلهای فونت بهصورت جداگانه.
- انتخاب نحوهٔ نوشتن و ارجاع به منابع خارجی و فایلهای رسانهای.
بهصورت پیشفرض، صادرات HTML یک سند HTML خودکفا تولید میکند که در آن اکثر منابع جاسازی شدهاند. این روش برای بهاشتراکگذاری یک فایل مناسب است، اما میتواند حجم خروجی را افزایش دهد. برای انتشار وب، منابع خارجی، DPI تصویر کمتر و فقط تعبیهٔ فونتهایی که بهطور قابل اعتمادی در محیط هدف موجود نیستند را درنظر بگیرید.
تبدیل ارائه به HTML
برای صادرات یک ارائه به HTML، آن را با Presentation بارگیری کنید و با SaveFormat.Html ذخیره کنید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
presentation.save("presentation.html", SaveFormat.Html)
finally:
presentation.dispose()
هر مثال presentation.pptx را از پوشهٔ کاری فعلی بارگیری میکند. قبل از اجرا، Aspose.Slides for Python via Java و یک زمان اجرای Java سازگار را نصب کنید. JVM یکبار برای هر پردازش Python راهاندازی میشود.
این مثال یک فایل HTML مینویسد. شئ ارائه در بلاک finally از بین میرود، که پس از صادرات، دستگیرههای فایل و منابع رندر را آزاد میکند.
پیکربندی صادرات HTML
HtmlOptions کلاس اصلی پیکربندی برای صادرات HTML است. تنظیمات رایج شامل موارد زیر میشود:
- setSlidesLayoutOptions: افزودن یادداشتها، نظرات، جزوات یا سایر اطلاعات طرح.
- setHtmlFormatter: تغییر ساختار سند HTML یا واگذاری فرمتدهی به یک کنترلکننده.
- setSlideImageFormat: تغییر نحوهٔ نمایش اسلایدها، مثلاً بهصورت SVG.
- setPicturesCompression: کنترل DPI تصویر و حجم خروجی.
- setDeletePicturesCroppedAreas: نگه داشتن یا حذف دادههای تصاویر برشخورده.
- setSvgResponsiveLayout: سازگار کردن محتوای SVG خروجی با ظرف خود.
- setShowHiddenSlides: شامل کردن اسلایدهای مخفی هنگام نیاز.
بخشهای زیر رایجترین گزینهها را بهصورت جداگانه نمایش میدهند تا بتوانید تنها گزینههایی را که جریان کاریتان نیاز دارد ترکیب کنید.
تبدیل اسلایدهای انتخابی به HTML
متد overload Presentation.save که شماره اسلایدها را میپذیرد، موقعیتهای اسلاید را بهصورت 1‑based در نظر میگیرد. حلقهٔ زیر هر اسلاید را در یک فایل HTML جداگانه ذخیره میکند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide_count = presentation.getSlides().size()
for slide_index in range(slide_count):
slide_number = slide_index + 1
slide_numbers = jpype.JArray(jpype.JInt)([slide_number])
html_file_name = f"slide-{slide_number}.html"
presentation.save(html_file_name, slide_numbers, SaveFormat.Html)
finally:
presentation.dispose()
از این الگو زمانی استفاده کنید که یک وبسایت یا برنامه به یک صفحهٔ HTML برای هر اسلاید نیاز داشته باشد. اگر هر اسلاید باید همان طرح را داشته باشد، یک شیء HtmlOptions ایجاد کنید و آن را به هر فراخوانی Presentation.save پاس بدهید.
ایجاد HTML واکنشگرا
ResponsiveHtmlController خروجی HTML واکنشگرا را از طریق HtmlFormatter فراهم میکند. زمانی که صفحهٔ خروجی باید بهتر به عرض مرورگر سازگار شود، از آن استفاده کنید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlFormatter, HtmlOptions, Presentation, ResponsiveHtmlController, SaveFormat
presentation = Presentation("presentation.pptx")
try:
controller = ResponsiveHtmlController()
formatter = HtmlFormatter.createCustomFormatter(controller)
html_options = HtmlOptions()
html_options.setHtmlFormatter(formatter)
presentation.save("presentation-responsive.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
برای طرح واکنشگرا مبتنی بر SVG، HtmlOptions.setSvgResponsiveLayout را با مقدار True فراخوانی کنید. این گزینه زمانی مفید است که محتوای اسلاید بهصورت علامتگذاری SVG مقیاسپذیر صادر میشود.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlOptions, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
html_options = HtmlOptions()
html_options.setSvgResponsiveLayout(True)
presentation.save("presentation-svg-responsive.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
گنجاندن یادداشتهای سخنران و نظرات
از NotesCommentsLayoutingOptions از طریق HtmlOptions.setSlidesLayoutOptions برای گنجاندن یادداشتهای سخنران یا نظرات استفاده کنید. بهطور پیشفرض یادداشتها و نظرات مخفی هستند مگر اینکه موقعیت آنها را انتخاب کنید.
فرض کنید ارائهٔ منبع شامل یادداشتهای سخنران باشد:
کد زیر محتوی اسلاید را بههمراه یادداشتهای سخنران زیر اسلاید صادر میکند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlOptions, NotesCommentsLayoutingOptions, NotesPositions, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
layout_options = NotesCommentsLayoutingOptions()
layout_options.setNotesPosition(NotesPositions.BottomFull)
html_options = HtmlOptions()
html_options.setSlidesLayoutOptions(layout_options)
presentation.save("presentation-with-notes.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
HTML صادرشده شامل ناحیهٔ یادداشتهاست:
برای صادرات نظرات، NotesCommentsLayoutingOptions.setCommentsPosition را فراخوانی کنید؛ بهعنوان مثال با CommentsPositions.Right یا CommentsPositions.Bottom. اگر فقط به نظرات نیاز دارید، NotesCommentsLayoutingOptions.setNotesPosition را حذف کنید. اگر به هر دو نیاز دارید، هر دو متد را فراخوانی کنید.
کنترل کیفیت تصویر و نواحی برشخورده
صادرات HTML میتواند تصاویر اسلاید را فشرده کند تا حجم خروجی کاهش یابد. مقدار موردنظر را به HtmlOptions.setPicturesCompression از PicturesCompression پاس دهید وقتی به کیفیت تصویر بالاتر احتیاج دارید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlOptions, PicturesCompression, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
html_options = HtmlOptions()
html_options.setPicturesCompression(PicturesCompression.Dpi150)
presentation.save("presentation-dpi-150.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
بهصورت پیشفرض، نواحی برشخوردهٔ تصاویر ممکن است از خروجی حذف شوند. فقط زمانی دادههای برشخورده را نگه دارید که کاربران باید بتوانند آن بخشهای پنهان تصویر را بازیابی یا بررسی کنند. نگهداشتن آنها میتواند حجم HTML را افزایش دهد.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlOptions, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
html_options = HtmlOptions()
html_options.setDeletePicturesCroppedAreas(False)
presentation.save("presentation-with-cropped-areas.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
افزودن CSS
برای استایل ساده، یک رشتهٔ CSS را به HtmlFormatter.createDocumentFormatter پاس دهید. این کار ساختار سند HTML پیرامونی را تغییر میدهد در حالی که Aspose.Slides همچنان محتوی اسلاید را رندر میکند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlFormatter, HtmlOptions, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
css_rules = "body { margin: 0; background: #f7f7f7; } .slide { margin: 24px auto; }"
formatter = HtmlFormatter.createDocumentFormatter(css_rules, True)
html_options = HtmlOptions()
html_options.setHtmlFormatter(formatter)
presentation.save("presentation-styled.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
برای افزودن سرصفحهٔ سفارشی سند، یک فایل CSS مرتبط یا علامتگذاری سفارشی اطراف اسلایدها و اشکال، از یک کنترلکنندهٔ فرمت‑دهی سفارشی از طریق یک پراکسی رابط JPype استفاده کنید و آن را به HtmlFormatter با HtmlFormatter.createCustomFormatter پاس دهید.
تعبیهٔ فونتها
اگر محیط هدف ممکن است فونتهای ارائه را نصب نکرده باشد، فونتها را در HTML با EmbedAllFontsHtmlController تعبیه کنید. تعبیه بهدقت بصری کمک میکند اما حجم خروجی را افزایش میدهد.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import EmbedAllFontsHtmlController, HtmlFormatter, HtmlOptions, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
font_names_to_exclude = jpype.JArray(jpype.JString)(["Arial"])
font_controller = EmbedAllFontsHtmlController(font_names_to_exclude)
formatter = HtmlFormatter.createCustomFormatter(font_controller)
html_options = HtmlOptions()
html_options.setHtmlFormatter(formatter)
presentation.save("presentation-embedded-fonts.html", SaveFormat.Html, html_options)
finally:
presentation.dispose()
فقط وقتی مطمئن هستید مرورگرها یا سیستمهای هدف فونتها را دارند، از تعبیه صرفنظر کنید. برای فونتهای برند یا کمتر رایج، تعبیه معمولاً امنتر است.
ذخیرهٔ منابع بهصورت خارجی
HTML خودکفا جابهجایی آسانی دارد، اما منابع Base64 جاسازیشده میتوانند فایل را بزرگ کنند. اگر برنامهٔ شما به فایلهای تصویر خارجی نیاز دارد، یک کنترلکنندهٔ پیوند منابع از طریق پراکسی JPype پیادهسازی کنید و به سازندهٔ HtmlOptions پاس دهید.
هنگام بیرونزدن منابع، دو مسیر را بهدقت انتخاب کنید:
- مسیر خروجی سیستم‑فایل، جایی که برنامهتان تصاویر، فونتها، صدا یا ویدئوهای تولیدشده را مینویسد.
- مسیر URL، که مرورگر از داخل سند HTML برای بارگذاری آن فایلها استفاده میکند.
صادرات فایلهای رسانهای
VideoPlayerHtmlController ویدئوها و صداها را صادر میکند و HTMLی مینویسد که میتواند آنها را در مرورگر پخش کند. سازندهٔ آن موارد زیر را میگیرد:
path: پوشهای که فایلهای رسانهای تولیدشده در آن نوشته میشوند.fileName: نام فایل HTML تولیدشده.baseUri: پیشوند URI مطلق که در پیوندهای HTML به فایلهای رسانهای استفاده میشود.
مثال زیر رسانههای از پیش تعبیهشده در presentation.pptx را صادر میکند. HTML تولیدشده فقط با نام فایل به فایلهای رسانهای ارجاع میدهد، نسبی به سند HTML؛ بنابراین path باید همان پوشهای باشد که فایل HTML نیز در آن قرار میگیرد. baseUri باید یک URI مطلق باشد: برای پیشنمایش محلی، یک URI file:/// از پوشه خروجی بسازید؛ برای برنامهٔ مستقر، از URL مطلق پوشهٔ منتشرشده استفاده کنید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import HtmlFormatter, HtmlOptions, Presentation, SVGOptions, SaveFormat, SlideImageFormat, VideoPlayerHtmlController
from pathlib import Path
output_directory = Path("html-output").resolve()
output_directory.mkdir(parents=True, exist_ok=True)
html_file_name = "presentation.html"
media_base_uri = output_directory.as_uri() + "/"
presentation = Presentation("presentation.pptx")
try:
controller = VideoPlayerHtmlController(str(output_directory), html_file_name, media_base_uri)
formatter = HtmlFormatter.createCustomFormatter(controller)
svg_options = SVGOptions(controller)
slide_image_format = SlideImageFormat.svg(svg_options)
html_options = HtmlOptions(controller)
html_options.setHtmlFormatter(formatter)
html_options.setSlideImageFormat(slide_image_format)
html_file_path = output_directory / html_file_name
presentation.save(str(html_file_path), SaveFormat.Html, html_options)
finally:
presentation.dispose()
برای هر کار صادرات، پوشههای خروجی یکتا استفاده کنید، بهویژه در برنامههای سرور. مسیرهای خروجی مشترک میتوانند باعث بازنویسی فایلهای تبدیلهای مختلف شوند.
عملکرد و مدیریت منابع
تبدیل HTML یک عملیات رندر است، بنابراین زمان پردازش و استفاده از حافظه به تعداد اسلایدها، وضوح تصویر، فونتها، افکتها، نمودارها و رسانههای جاسازیشده وابسته است. مقادیر DPI تصویر بالاتر که به HtmlOptions.setPicturesCompression پاس میشوند، فونتهای جاسازیشده، خروجی SVG و نگهداشتن نواحی برشخورده میتوانند دقت را افزایش دهند اما معمولاً حجم خروجی را بزرگ میکنند.
برای تبدیل دستهای:
- هر نمونهٔ Presentation را بلافاصله پس از استفاده آزاد کنید.
- برای هر کار پوشهٔ خروجی جداگانه استفاده کنید.
- مگر اینکه دقت بصری ضروری باشد، از تعبیهٔ فونتهای رایج خودداری کنید.
- برای پیشنمایش یا تصویرهای بندانگشتی، DPI تصویر را کمتر کنید.
- تا زمانی که مسیرهای انتشار نهایی شوند، ارائهٔ منبع، HTML تولیدشده و منابع خارجی را در کنار هم نگه دارید.
سوالات متداول
آیا پیوندهای هیپرتکست در خروجی HTML حفظ میشوند؟
بله. پیوندهای هیپرتکست ارائه به HTML صادر میشوند و وقتی URL هدف معتبر باشد قابل کلیکاند.
آیا میتوانم ارائهها را بهصورت موازی به HTML تبدیل کنم؟
بله، اما یک نمونهٔ Presentation را بین رشتهها بهاشتراک نگذارید. فایلهای متفاوت را با نمونههای ارائهٔ مستقل، جریانهای جداگانه و مسیرهای خروجی جداگانه پردازش کنید. برای جزئیات به راهنمای multithreading guidance مراجعه کنید.
آیا شیء ارائه مبتنی بر رشته (thread‑safe) است؟
خیر. یک نمونهٔ Presentation باید در یک رشته بارگیری، تغییر، ذخیره و آزاد شود. برای کارهای موازی، یک نمونهٔ مستقل برای هر رشته یا فرآیند ایجاد کنید.
چرا فایل HTML تولیدشده بزرگ است؟
صادرات پیشفرض میتواند منابع را مستقیماً در HTML جاسازی کند. فونتهای جاسازیشده، تصاویر DPI بالا، رسانهها, محتواهای SVG و نگهداشتن نواحی برشخورده تصویر نیز حجم را افزایش میدهند. برای کاهش حجم، از منابع خارجی استفاده کنید، فونتهای رایج را از تعبیه حذف کنید و مقدار DPI پایینتری را به HtmlOptions.setPicturesCompression پاس دهید وقتی اندازهٔ کوچکتر مهمتر از حداکثر دقت باشد.
چرا مقدار font‑size در HTML میتواند با مقدار PowerPoint متفاوت باشد؟
صفحهٔ خروجی میتواند از سیستمهای مختصات SVG و تبدیلهای مقیاس استفاده کند. یک مقدار CSS یا SVG بهتنهایی اندازهٔ نهایی نمایش دادهشده را توصیف نمیکند. اسلاید رندرشده را در سطح بزرگنمایی مورد نظر مقایسه کنید و در صورت متفاوت بودن، در دسترس بودن فونت را بررسی کنید.
چگونه باید baseUri را برای صادرات رسانهها انتخاب کنم؟
baseUri را از منظر مرورگر انتخاب کنید و بهعنوان یک URI مطلق پاس دهید. برای پیشنمایش محلی میتوانید آن را از پوشهٔ خروجی با output_directory.as_uri() + "/" بهدست آورید. برای انتشار، از URL مطلق پوشهٔ منتشرشده استفاده کنید. مسیر سیستم‑فایل path و baseUri مرورگر نیازی به یک رشتهٔ یکسان ندارند، اما باید به همان مکان اشاره کنند و آن مکان باید پوشهٔ حاوی فایل HTML تولیدشده باشد زیرا پیوندهای رسانهای بهصورت نسبی نسبت به آن نوشته میشوند.
آیا میتوانم اسلایدهای مخفی را هم شامل کنم؟
بله. هنگام نیاز به صادرات اسلایدهای مخفی، HtmlOptions.setShowHiddenSlides را با مقدار True فراخوانی کنید.