تصدير عروض تقديمية إلى HTML مع صور مرتبطة خارجيًا في Python

نظرة عامة

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

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

  • تقليل حجم مستند HTML؛
  • تخزين الصور مؤقتًا بشكل منفصل في المتصفح أو شبكة توزيع المحتوى (CDN)؛
  • فحص، استبدال، ضغط، أو معالجة ما بعد إنشاء الصور بعد التصدير؛
  • جعل بنية الإخراج أقرب إلى ما يتوقعه تطبيق الويب.

للعمل العام لتحويل HTML، راجع تحويل عروض PowerPoint إلى HTML. يركز هذا المقال على جزء ربط الصور في عملية التصدير.

كيف يعمل تصدير الصور المرتبطة

في .NET و Java، يمثل ILinkEmbedController واجهة رد النداء التي يستخدمها المصدر لتحديد ما إذا كان يجب تضمين المورد أو ربطه. في Python عبر .NET، لا يمكن للفئات في Python تنفيذ هذه الواجهة مباشرةً حاليًا، لذا فإن سير العمل العملي هو:

  1. تصدير العرض التقديمي إلى HTML باستخدام HtmlOptions؛
  2. استخدام SlideImageFormat مع SVGOptions بحيث تُمثل الشرائح كـ SVG في HTML؛
  3. نقل بيانات الصور بصيغة Base64 من عناوين URL من نوع data: داخل HTML إلى ملفات منفصلة؛
  4. استبدال عناوين URL الأصلية من نوع data: بروابط نسبية مثل assets/resource-1.jpg.

مسار نظام الملفات وعنوان URL في المتصفح هما اعتباران منفصلان. على سبيل المثال، يكتب النموذج أدناه ملفات الصور إلى html-output/assets على القرص، بينما يحتوي HTML على عناوين URL نسبية مثل assets/resource-1.jpg. يقوم المتصفح بحل هذه العناوين نسبةً إلى ملف HTML الذي يحتوي على الرابط.

تصدير HTML مع صور مرتبطة

المثال التالي بلغة Python ينشئ دليل إخراج، يحفظ ملف HTML هناك، يخزن الصور المستخرجة في دليل فرعي assets، ويعيد كتابة عناوين URL للصور بصيغة Base64 إلى روابط نسبية. يستخرج المثال صيغ صور Base64 الشائعة عندما توفر Aspose.Slides امتداد ملف آمن. تبقى عناوين URL للبيانات غير المعروفة مضمَّنة.

import base64
import os
import re

import aspose.slides as slides
import aspose.slides.export as slides_export


EXTENSIONS_BY_CONTENT_TYPE = {
    "image/jpeg": ".jpg",
    "image/png": ".png",
    "image/gif": ".gif",
    "image/bmp": ".bmp",
    "image/svg+xml": ".svg",
    "image/tiff": ".tiff",
    "image/x-emf": ".emf",
    "image/x-wmf": ".wmf",
}

DATA_URI_PATTERN = re.compile(
    r"data:(?P<content_type>[-\w.+]+/[-\w.+]+);base64,(?P<data>[A-Za-z0-9+/=\r\n]+)"
)


def export_presentation_to_html_with_linked_images(
    input_file_path,
    output_directory,
    asset_directory_name="assets",
):
    asset_directory = os.path.join(output_directory, asset_directory_name)

    os.makedirs(output_directory, exist_ok=True)
    os.makedirs(asset_directory, exist_ok=True)

    html_options = slides_export.HtmlOptions()
    html_options.html_formatter = slides_export.HtmlFormatter.create_document_formatter("", False)
    html_options.slide_image_format = slides_export.SlideImageFormat.svg(
        slides_export.SVGOptions()
    )

    html_file_path = os.path.join(output_directory, "presentation.html")

    with slides.Presentation(input_file_path) as presentation:
        presentation.save(html_file_path, slides_export.SaveFormat.HTML, html_options)

    externalize_base64_images(html_file_path, asset_directory, asset_directory_name)


def externalize_base64_images(html_file_path, asset_directory, asset_directory_name):
    with open(html_file_path, "r", encoding="utf-8-sig") as html_file:
        html_content = html_file.read()

    saved_resource_names = {}
    resource_index = 1

    def replace_data_uri(match):
        nonlocal resource_index

        data_uri = match.group(0)
        if data_uri in saved_resource_names:
            return saved_resource_names[data_uri]

        content_type = match.group("content_type").lower()
        extension = EXTENSIONS_BY_CONTENT_TYPE.get(content_type)
        if extension is None:
            return data_uri

        encoded_data = match.group("data")
        image_data = base64.b64decode(encoded_data)
        if len(image_data) == 0:
            return data_uri

        file_name = f"resource-{resource_index}{extension}"
        resource_index += 1

        file_path = os.path.join(asset_directory, file_name)
        with open(file_path, "wb") as image_file:
            image_file.write(image_data)

        linked_url = f"{asset_directory_name}/{file_name}"
        saved_resource_names[data_uri] = linked_url
        return linked_url

    updated_html_content = DATA_URI_PATTERN.sub(replace_data_uri, html_content)

    with open(html_file_path, "w", encoding="utf-8", newline="\n") as html_file:
        html_file.write(updated_html_content)


input_file_path = "presentation.pptx"
output_directory = "html-output"

export_presentation_to_html_with_linked_images(input_file_path, output_directory)

بعد التصدير، قد يحتوي مجلد الإخراج على البنية التالية:

html-output/
  presentation.html
  assets/
    resource-1.jpg
    resource-2.png

الملفات الفعلية تعتمد على محتوى العرض التقديمي وخيارات التصدير. على سبيل المثال، تُصدَّر الصور النقطية عادةً كـ JPEG أو PNG. قد تختار Aspose.Slides ترميز صورة مختلف عن ذلك المستخدم في العرض الأصلي إذا أدى ذلك إلى ملف أصغر أو أكثر ملاءمة. تُصدَّر الصور الشفافة كـ PNG.

اختيار عناوين URL للنشر

يستخدم النموذج بادئة URL نسبية: assets/. إذا تم فتح presentation.html من html-output/presentation.html، يقوم المتصفح بتحميل html-output/assets/resource-1.jpg.

استخدم اسم دليل أصول مختلف أو أعد كتابة الروابط المولدة عندما تُنشر الملفات في موقع آخر:

  • استخدم assets/ عندما يكون دليل الأصول بجوار ملف HTML؛
  • استخدم ../assets/ عندما يكون دليل الأصول مستوىً واحدًا فوق ملف HTML؛
  • استخدم https://cdn.example.com/presentations/job-123/assets/ عندما تُرفع الملفات إلى CDN أو خادم ملفات ثابتة.

في التطبيقات الخادمة، استخدم دليل إخراج فريد أو بادئة تخزين كائن لكل وظيفة تحويل لتجنب الكتابة فوق ملفات تصدير أخرى.

متى يجب تضمين الصور بدلاً من ذلك

لا يزال تضمين HTML بصيغة Base64 مفيدًا عندما يجب أن يكون الإخراج ملفًا واحدًا، مثل مرفق بريد إلكتروني، أو معاينة دون اتصال، أو مستند سيتم نقله دون مجلد أصول داعم. تُعد الصور المرتبطة خيارًا أفضل عندما يتم تقديم HTML عبر تطبيق ويب، أو تخزينه في نظام إدارة محتوى، أو تحسينه عبر خط أنابيب بناء، أو تخزينه مؤقتًا في المتصفحات بشكل مستقل عن HTML.

الأسئلة المتكررة

هل يمكنني استخراج الصور فقط وإبقاء الموارد الأخرى مضمَّنة؟

نعم. يستخرج النموذج بيانات Base64 من نوع image/* التي تُدرج أنواع محتواها في EXTENSIONS_BY_CONTENT_TYPE. تبقى عناوين URL للبيانات الأخرى مضمَّنة.

لماذا يختلف امتداد الصورة المستخرجة عن عرض PowerPoint الأصلي؟

قد تقوم Aspose.Slides بإعادة ترميز الصور النقطية أثناء تصدير HTML لتحسين الحجم أو توافق المتصفح. على سبيل المثال، قد تُكتب صورة من الملف الأصلي كـ JPEG أو PNG حسب النتيجة التي يتم عرضها.

هل تعمل عناوين URL النسبية بعد نقل ملف HTML؟

تعمل عناوين URL النسبية فقط إذا تم الحفاظ على بنية المجلدات النسبية نفسها. إذا أشار HTML إلى assets/resource-1.png، يجب أن يبقى مجلد assets بجوار ملف HTML ما لم تُولِّد بادئة URL مختلفة.

هل يجب على التطبيقات الخادمة إعادة استخدام نفس مجلد الإخراج؟

لا. استخدم دليل إخراج فريد أو بادئة تخزين لكل وظيفة تحويل. هذا يحد من تصادم أسماء الملفات ويمنع كتابة مورد من تصدير واحد فوق موارد تصدير آخر.

الحصول على خلفية الشريحة بالكامل من عرض تقديمي كصورة استبدال الصور داخل مجموعة صور العرض