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

نظرة عامة

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

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

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

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

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

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

using var presentation = new Presentation("presentation.pptx");

presentation.Save("presentation.html", SaveFormat.Html);

تكتب هذه العينة ملف HTML واحد. يتم إتلاف كائن العرض التقديمي عبر بيان using، والذي يحرّر مؤشرات الملفات وموارد التصيير بعد التصدير.

استخدام HtmlOptions

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

• SlidesLayoutOptions: يضيف الملاحظات أو التعليقات أو النشرات أو معلومات تخطيط أخرى.
• HtmlFormatter: يغيّر بنية مستند HTML أو يوجّه التنسيق إلى متحكم.
• SlideImageFormat: يغيّر طريقة تمثيل الشرائح، مثلاً كملف SVG.
• PicturesCompression: يتحكم في DPI الصورة وحجم الناتج.
• DeletePicturesCroppedAreas: يحتفظ أو يزيل بيانات الصورة المقصوصة.
• SvgResponsiveLayout: يجعل محتوى SVG المصدّر يتكيف مع الحاوية.
• ShowHiddenSlides: يتضمن الشرائح المخفية عند الحاجة.

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

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

يتقبل التحميل الزائد لـ Presentation.Save أرقام الشرائح باستخدام مواضع 1‑based. الحلقة أدناه تحفظ كل شريحة في ملف HTML منفصل.

using var presentation = new Presentation("presentation.pptx");

var slideCount = presentation.Slides.Count;

for (var slideIndex = 0; slideIndex < slideCount; slideIndex++)
{
    var slideNumber = slideIndex + 1;
    var slideNumbers = new[] { slideNumber };
    var htmlFileName = $"slide-{slideNumber}.html";

    presentation.Save(htmlFileName, slideNumbers, SaveFormat.Html);
}

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

إنشاء HTML مستجيب

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

using var presentation = new Presentation("presentation.pptx");

var controller = new ResponsiveHtmlController();
var formatter = HtmlFormatter.CreateCustomFormatter(controller);

var htmlOptions = new HtmlOptions
{
    HtmlFormatter = formatter
};

presentation.Save("presentation-responsive.html", SaveFormat.Html, htmlOptions);

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

using var presentation = new Presentation("presentation.pptx");

var htmlOptions = new HtmlOptions
{
    SvgResponsiveLayout = true
};

presentation.Save("presentation-svg-responsive.html", SaveFormat.Html, htmlOptions);

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

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

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

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

using var presentation = new Presentation("presentation.pptx");

var layoutOptions = new NotesCommentsLayoutingOptions
{
    NotesPosition = NotesPositions.BottomFull
};

var htmlOptions = new HtmlOptions
{
    SlidesLayoutOptions = layoutOptions
};

presentation.Save("presentation-with-notes.html", SaveFormat.Html, htmlOptions);

يتضمن HTML المصدّر منطقة الملاحظات:

لتصدير التعليقات، عيّن CommentsPosition، مثلاً إلى CommentsPositions.Right أو CommentsPositions.Bottom. إذا كنت بحاجة فقط إلى التعليقات، احذف NotesPosition. إذا كنت بحاجة إلى الملاحظات والتعليقات معًا، عيّن الخاصيتين.

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

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

using var presentation = new Presentation("presentation.pptx");

var htmlOptions = new HtmlOptions
{
    PicturesCompression = PicturesCompression.Dpi150
};

presentation.Save("presentation-dpi-150.html", SaveFormat.Html, htmlOptions);

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

using var presentation = new Presentation("presentation.pptx");

var htmlOptions = new HtmlOptions
{
    DeletePicturesCroppedAreas = false
};

presentation.Save("presentation-with-cropped-areas.html", SaveFormat.Html, htmlOptions);

إضافة CSS

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