تحويل عروض PowerPoint التقديمية إلى HTML في Python

نظرة عامة

يمكن لـ Aspose.Slides for Python عبر .NET حفظ عروض PowerPoint التقديمية كـ HTML دون الحاجة إلى Microsoft PowerPoint. التحويل الأساسي هو تحميل واحد لـ Presentation ثم استدعاء save باستخدام SaveFormat. استخدم HtmlOptions عندما تحتاج إلى التحكم في تخطيط التصدير، الخطوط، الصور، الملاحظات، التعليقات، إخراج SVG، أو الموارد المرتبطة.

يركز هذا الدليل على سيناريوهات تصدير HTML العملية:

• تصدير عرض تقديمي كامل أو شرائح مختارة.
• إنشاء HTML ثابت التخطيط، متجاوب، أو مبني على SVG.
• تضمين ملاحظات المتحدث والتعليقات.
• التحكم في جودة الصورة وبيانات الصورة المقطوعة.
• تضمين الخطوط أو حفظ ملفات الخط بشكل منفصل.
• اختيار طريقة كتابة ومراجعة الموارد الخارجية وملفات الوسائط.

بشكل افتراضي، ينتج تصدير HTML مستند HTML ذاتي‑الإحتواء حيث تُضمّن معظم الموارد. هذا مريح لمشاركة ملف واحد، لكنه قد يزيد من حجم الناتج. للنشر على الويب، ضع في اعتبارك الموارد الخارجية، خفض DPI الصورة، وتضمين الخطوط فقط عندما لا تكون متوفرة بثقة في البيئة المستهدفة.

تحويل عرض تقديمي إلى HTML

لتصدير عرض تقديمي إلى HTML، حمله باستخدام Presentation واحفظه باستخدام SaveFormat.

import aspose.slides as slides

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

هذا المثال يكتب ملف HTML واحد. جملة with تتخلص من كائن العرض وتطلق مقابض الملفات وموارد التصيير بعد التصدير.

استخدام HtmlOptions

HtmlOptions هي الفئة الرئيسية للتهيئة لتصدير HTML. تشمل الإعدادات الشائعة:

• slides_layout_options: يضيف الملاحظات، التعليقات، الملخصات، أو معلومات تخطيط أخرى.
• html_formatter: يغيّر بنية مستند HTML أو يفوض التنسيق إلى المتحكم.
• slide_image_format: يغيّر طريقة تمثيل الشرائح، على سبيل المثال كـ SVG.
• pictures_compression: يتحكم في DPI الصورة وحجم الناتج.
• delete_pictures_cropped_areas: يحتفظ أو يزيل بيانات الصورة المقطوعة.
• svg_responsive_layout: يجعل محتوى SVG المُصدّر يتكيف مع حاويته.
• show_hidden_slides: يتضمن الشرائح المخفية عند الحاجة.

توضح الأقسام التالية أكثر الخيارات شيوعًا بشكل منفصل حتى تتمكن من دمج فقط ما تحتاجه سير عملك.

تحويل شرائح مختارة إلى HTML

التحميل الزائد save الذي يقبل أرقام الشرائح يستخدم مواقع شرائح تبدأ من 1. الحلقة أدناه تحفظ كل شريحة إلى ملف HTML منفصل.

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)

استخدم هذا النمط عندما يحتاج موقع ويب أو تطبيق إلى صفحة HTML واحدة لكل شريحة. إذا كان يجب أن يكون لكل شريحة نفس التخطيط، أنشئ كائنًا واحدًا من HtmlOptions ومرره إلى كل استدعاء save.

إنشاء HTML متجاوب

ResponsiveHtmlController يوفر ناتج HTML متجاوب عبر HtmlFormatter. استخدمه عندما ينبغي للصفحة المصدرة أن تتكيف بشكل أفضل مع عرض المتصفح.

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)

للتخطيط المتجاوب المستند إلى SVG، اضبط svg_responsive_layout على HtmlOptions. هذا مفيد عندما يُصدّر محتوى الشريحة كعلامات SVG قابلة للتوسيع.

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)

تضمين ملاحظات المتحدث والتعليقات

استخدم NotesCommentsLayoutingOptions من خلال html_options.slides_layout_options لتضمين ملاحظات المتحدث أو التعليقات. تكون الملاحظات والتعليقات مخفية افتراضيًا ما لم تُحدد مواقعها.

لنفترض أن العرض المصدر يحتوي على ملاحظات المتحدث:

الكود التالي يُصدّر محتوى الشريحة مع ملاحظات المتحدث أسفل الشريحة.

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 المُصدّر منطقة الملاحظات:

لتصدير التعليقات، اضبط comments_position، على سبيل المثال إلى CommentsPositions.RIGHT أو CommentsPositions.BOTTOM. إذا كنت تحتاج إلى التعليقات فقط، احذف notes_position. إذا كنت تحتاج إلى كل من الملاحظات والتعليقات، اضبط الخاصيتين.

التحكم في جودة الصورة والمساحات المقصوصة

يمكن لتصدير HTML ضغط صور الشرائح لتقليل حجم الناتج. اضبط pictures_compression إلى قيمة من PicturesCompression عندما تحتاج إلى جودة صورة أعلى.

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)

افتراضيًا، قد تُزال المناطق المقصوصة من الصور في الناتج المصدّر. احتفظ بالبيانات المقصوصة فقط عندما يجب أن يتمكن المستخدمون من استعادة أو فحص تلك الأجزاء المخفية من الصورة. الاحتفاظ بها قد يزيد من حجم 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)

إضافة CSS

للتنسيق البسيط، مرّر سلسلة CSS إلى HtmlFormatter. يغيّر هذا مستند HTML المحيط بينما يواصل Aspose.Slides تصيير محتوى الشريحة.

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)

لإنشاء رأس مستند مخصص، ملف CSS مرتبط، أو تعليمات HTML مخصّصة حول الشرائح والأشكال، استخدم متحكم تنسيق مخصّص ومرره إلى HtmlFormatter باستخدام create_custom_formatter.

تضمين الخطوط

إذا كان من الممكن أن لا تكون خطوط العرض موجودة في البيئة المستهدفة، قم بتضمين الخطوط في HTML باستخدام EmbedAllFontsHtmlController. يضيف التضمين دقة بصرية أكبر لكنه يزيد من حجم الناتج.

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)

استثنِ الخط فقط عندما تكون واثقًا من أن المتصفحات أو الأنظمة المستهدفة توفره بالفعل. للخطوط الخاصة بالعلامة التجارية أو الخطوط الأقل شيوعًا، يعتبر التضمين غالبًا أكثر أمانًا.

ربط ملفات الخط بدلاً من تضمينها

لتقليل حجم ملف HTML، يمكنك كتابة بيانات الخط إلى ملفات WOFF منفصلة وإضافة قواعد @font-face إلى HTML. يتطلب ذلك متحكم يخصص طريقة كتابة بيانات الخط أثناء التصدير. في Python عبر .NET، نفّذ ذلك المتحكم في تجميعة مساعدة .NET صغيرة، حمّلها في Python، ومرّر كائن المساعدة إلى HtmlFormatter باستخدام create_custom_formatter.

عند فصل الخطوط خارجيًا، اختر مسارين عمدًا:

• دليل الإخراج في نظام الملفات حيث سيتم كتابة ملفات WOFF المتولدة.
• مسار URL الذي سيظهر في مستند HTML والذي سيستخدمه المتصفح لتحميل ملفات الخط تلك.

احتفظ بملف HTML وملفات الخط المتولدة معًا حتى تصبح مسارات النشر نهائية. إذا نُشرت الملفات في موقع آخر، اجعل بادئة URL مطابقة لمسار URL المنشور.

حفظ الموارد خارجيًا

HTML ذاتية الإحتواء سهلة النقل، لكن الموارد المضمَّنة بصيغة Base64 قد تجعل الملف كبيرًا. إذا كان تطبيقك يحتاج إلى صور، خطوط، صوت أو فيديو خارجي، استخدم متحكم ربط/تضمين مخصص ومرره إلى مُنشئ HtmlOptions.

عند فصل الموارد خارجيًا، اختر مسارين عمدًا:

• مسار الإخراج في نظام الملفات، حيث يكتب تطبيقك الصور، الخطوط، الصوت أو الفيديو المتولد.
• مسار URL، وهو ما يستخدمه المتصفح من مستند HTML لتحميل تلك الملفات.

لمناقشة شاملة حول ربط الصور، راجع تصدير العروض التقديمية إلى HTML مع صور مرتبطة خارجيًا.

تصدير ملفات الوسائط

VideoPlayerHtmlController يصدر ملفات الفيديو والصوت ويكتب HTML يمكن تشغيله في المتصفح. يأخذ المُنشئ:

• path: الدليل الذي سيتم كتابة ملفات الوسائط المتولدة فيه.
• file_name: اسم ملف HTML المتولد.
• base_uri: بادئة الـ URI المطلقة المستخدمة في روابط HTML لملفات الوسائط.

إذا كان ملف HTML هو html-output/presentation.html وكانت ملفات الوسائط محفوظة في html-output/media، يجب أن يشير path إلى دليل الوسائط على القرص، بينما يجب أن يشير base_uri إلى نفس الدليل من وجهة نظر المتصفح. للمعاينة المحلية، يمكنك بناء URI من النوع file:/// من دليل الوسائط. لتطبيق منشور، استخدم عنوان URL المطلق لدليل الوسائط المنشور.

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)

استخدم دلائل إخراج فريدة لكل مهمة تصدير، خاصة في تطبيقات الخادم. قد تتسبب دلائل الإخراج المشتركة في استبدال ملفات من تحويلات مختلفة بعضها البعض.

الأداء وإدارة الموارد

تحويل HTML هو عملية تصيير، لذا يعتمد زمن المعالجة واستهلاك الذاكرة على عدد الشرائح، دقة الصورة، الخطوط، التأثيرات، المخططات، والوسائط المضمنة. القيم الأعلى لـ DPI في pictures_compression، الخطوط المضمنة، إخراج SVG، والاحتفاظ بمناطق الصورة المقصوصة قد تحسن الدقة لكنها عادةً ما تزيد من حجم الناتج.

للتحويل على دفعات:

• تخلص من كل كائن Presentation فورًا.
• استخدم دلائل إخراج منفصلة لكل مهمة.
• تجنّب تضمين الخطوط الشائعة إلا إذا كانت الدقة تتطلب ذلك.
• قلل DPI الصورة عندما يكون HTML للمعاينة أو الصور المصغرة.
• احفظ العرض المصدر، HTML المتولد، والموارد الخارجية معًا حتى تصبح مسارات النشر نهائية.

الأسئلة الشائعة

هل تم الحفاظ على الروابط التشعبية في ناتج HTML؟

نعم. يتم تصدير روابط العروض التقديمية إلى HTML وتبقى قابلة للنقر عندما يكون عنوان URL الهدف صالحًا.

هل يمكنني تحويل العروض التقديمية إلى HTML بشكل متوازي؟

نعم، لكن لا تشارك كائن Presentation واحد بين الخيوط. عالج ملفات مختلفة باستخدام كائنات عرض منفصلة، تدفقات منفصلة، ودلائل إخراج منفصلة. راجع إرشادات تعدد الخيوط للحصول على التفاصيل.

هل كائن Presentation آمن للاستخدام عبر خيوط متعددة؟

لا. يجب تحميل وتعديل وحفظ وتطهير كائن Presentation واحد على خيط واحد فقط. للعمل المتوازي، أنشئ كائنًا مستقلاً لكل خيط أو عملية.

لماذا يكون ملف HTML المتولد كبيرًا؟

يمكن للتصدير الافتراضي تضمين الموارد مباشرة في HTML. الخطوط المضمنة، الصور عالية DPI، الوسائط، محتوى SVG، والاحتفاظ بمناطق الصورة المقصوصة تزيد أيضًا من الحجم. استخدم موارد خارجية، استثنِ الخطوط الشائعة من التضمين، وقلل pictures_compression عندما يكون حجم الناتج الصغير أهم من أقصى دقة.

كيف يجب اختيار base_uri لتصدير الوسائط؟

اختر base_uri من وجهة نظر المتصفح ومرره كـ URI مطلق. للمعاينة المحلية، يمكنك استنتاجه من دليل الإخراج باستخدام Path(media_directory).as_uri() + "/". للنشر، استخدم عنوان URL المطلق للدليل الإعلامي المنشور. لا يلزم أن يكون مسار نظام الملفات path و base_uri المتصفح نفس النص، لكن يجب أن يصفا نفس موقع المورد.

هل يمكنني تضمين الشرائح المخفية؟

نعم. اضبط show_hidden_slides = True على HtmlOptions عندما يجب تصدير الشرائح المخفية.