تحويل العروض التقديمية إلى HTML5 في Java

نظرة عامة

هذه المقالة تشرح كيفية تحويل عروض PowerPoint إلى HTML5 باستخدام Aspose.Slides for Java. تغطي التصدير الأساسي، والتحكم في رسوميات الأشكال الانتقالية والانتقالات بين الشرائح، وتنسيق التعليقات. كما تقارن مخرجات HTML5 بمخرجات SVG القياسية لتصدير HTML.

تصدير PowerPoint إلى HTML5

يقوم المثال التالي بتحميل عرض تقديمي من دليل العمل ويحفظه بتنسيق HTML5. يستخدم إعدادات التصدير الافتراضية؛ المثال التالي يوضح كيفية التحكم في تشغيل الرسوم المتحركة بشكل صريح. استبدل مسار الإدخال بالمسار إلى عرضك التقديمي.

import com.aspose.slides.*;

Presentation presentation = new Presentation("pres.pptx");
try {
    presentation.save("pres.html", SaveFormat.Html5);
} finally {
    presentation.dispose();
}

للتصدير دون تشغيل رسوميات الشكل أو الانتقالات بين الشرائح، مرّر false إلى setAnimateShapes وsetAnimateTransitions في Html5Options. هذه الإعدادات مستقلة، لذا يمكنك تفعيل واحدة وتعطيل الأخرى. المثال يصدر العرض التقديمي مع تعطيل كلا النوعين من الرسوم المتحركة في الصفحة المُولدة.

import com.aspose.slides.*;

Html5Options html5Options = new Html5Options();
html5Options.setAnimateShapes(false);
html5Options.setAnimateTransitions(false);

Presentation presentation = new Presentation("pres.pptx");
try {
    presentation.save("pres5.html", SaveFormat.Html5, html5Options);
} finally {
    presentation.dispose();
}

تصدير PowerPoint إلى HTML

يستخدم تصدير HTML القياسي نهج عرض مختلف: يُمثل محتوى الشريحة بواسطة SVG داخل صفحة HTML. يقوم المثال التالي بتحويل عرض تقديمي إلى مستند HTML باستخدام هذا النهج.

import com.aspose.slides.*;

Presentation presentation = new Presentation("pres.pptx");
try {
    presentation.save("pres.html", SaveFormat.Html);
} finally {
    presentation.dispose();
}

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

<body>
<div class="slide" name="slide" id="slideslideIface1">
     <svg version="1.1">
         <g> THE SLIDE CONTENT GOES HERE </g>
     </svg>
</div>
</body>

تصدير PowerPoint إلى عرض شرائح HTML5

يولد تصدير HTML5 صفحة لعرض وتنقل شرائح العرض التقديمي في المتصفح. يُمكّن هذا المثال كل من setAnimateShapes وsetAnimateTransitions لتتمكن عرض الشرائح المُصدّر من تشغيل التأثيرات من العرض الأصلي.

استخدم عرضًا تقديميًا يحتوي بالفعل على رسوميات الشكل وانتقالات الشرائح لرؤية تأثير هذه الإعدادات. تمكينها لا يضيف تأثيرات جديدة إلى الشرائح التي لا تحتوي على أي منها. بعد التصدير، افتح مستند HTML5 المُولّد في متصفح مع توفر الملفات الداعمة.

import com.aspose.slides.*;

Html5Options html5Options = new Html5Options();
html5Options.setAnimateShapes(true);
html5Options.setAnimateTransitions(true);

Presentation presentation = new Presentation("pres.pptx");
try {
    presentation.save("HTML5-slide-view.html", SaveFormat.Html5, html5Options);
} finally {
    presentation.dispose();
}

تحويل عرض تقديمي إلى مستند HTML5 مع التعليقات

يمكنك تضمين تعليقات الشرائح الموجودة في مخرجات HTML5 حتى يتمكن القارئ من رؤية الملاحظات بجانب محتوى الشريحة. المثال في هذا القسم يتوقع أن يحتوي العرض الأصلي على تعليقات، كما هو موضح أدناه. يقوم بتصدير تلك التعليقات؛ لا ينشئ تعليقات جديدة.

تعليقان على شريحة العرض التقديمي

مرّر كائن NotesCommentsLayoutingOptions إلى طريقة setSlidesLayoutOptions في Html5Options. استخدم setCommentsPosition لتحديد Right من تعداد CommentsPositions لتوضيح وضع التعليقات إلى يمين كل شريحة.

يقوم المثال التالي بتصدير العرض إلى HTML5 مع تخطيط التعليقات هذا. العرض التقديمي بدون تعليقات لن يحتوي على نص تعليق للعرض.

import com.aspose.slides.*;

NotesCommentsLayoutingOptions layoutOptions = new NotesCommentsLayoutingOptions();
layoutOptions.setCommentsPosition(CommentsPositions.Right);

Html5Options html5Options = new Html5Options();
html5Options.setSlidesLayoutOptions(layoutOptions);

Presentation presentation = new Presentation("sample.pptx");
try {
    presentation.save("output.html", SaveFormat.Html5, html5Options);
} finally {
    presentation.dispose();
}

الصورة أدناه توضح مستند HTML5 المُصدّر مع عرض التعليقات بجانب الشريحة.

التعليقات في مستند HTML5 الناتج

استبعاد الروابط التشعبية JavaScript أثناء التصدير

افترض أن hyperlinks.pptx يحتوي على نص مرتبط بوجهة javascript:alert('Hello') ورابط عادي https://example.com/. لاستبعاد الرابط التشعبي JavaScript أثناء التصدير، مرّر true إلى SaveOptions.setSkipJavaScriptLinks. الوضع الافتراضي هو false، لذا لا يتم تصفية هذه الروابط ما لم تمكّن الخيار.

يقوم المثال التالي بتحميل العرض التقديمي من دليل العمل وتصديره باستخدام Html5Options:

import com.aspose.slides.*;

Html5Options html5Options = new Html5Options();
html5Options.setSkipJavaScriptLinks(true);

Presentation presentation = new Presentation("hyperlinks.pptx");
try {
    presentation.save("filtered-html5.html", SaveFormat.Html5, html5Options);
} finally {
    presentation.dispose();
}

يستثني الملف المُصدّر الرابط التشعبي JavaScript مع الإبقاء على نصه والرابط HTTPS العادي. يبقى العرض الأصلي دون تغيير.

يقوم هذا الخيار بتصفية الروابط التشعبية JavaScript؛ لكنه لا يزيل جميع السكريبتات أو المحتوى النشط الآخر، ولا يضمن الامتثال لـ CSP. على سبيل المثال، لا يزال مخرج HTML5 يتضمن سكريبتات لتنقل الشرائح والرسوم المتحركة.

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

هل يمكنني التحكم فيما إذا كانت رسوميات الكائنات وانتقالات الشرائح ستعمل في HTML5؟

نعم، يوفر تصدير HTML5 خيارات منفصلة لتمكين أو تعطيل رسوميات الشكل وانتقالات الشرائح.

هل يتم دعم التعليقات، وأين يمكن وضعها بالنسبة للشريحة؟

نعم، يمكن تضمين التعليقات الموجودة في مخرجات HTML5 وتحديد موضعها (مثلاً إلى يمين الشريحة) من خلال إعدادات التخطيط للملاحظات والتعليقات.

هل يمكنني تخطي الروابط التي تستدعي JavaScript لأسباب أمنية أو بسبب CSP؟

نعم، يتيح لك إعداد setSkipJavaScriptLinks تخطي الروابط التشعبية التي تحتوي على استدعاءات JavaScript أثناء الحفظ. الوضع الافتراضي هو false. راجع استبعاد الروابط التشعبية JavaScript أثناء التصدير للحصول على مثال لتصدير HTML5 ونطاق الفلتر. هذا الإعداد لا يزيل JavaScript المستخدم من قبل عارض HTML5 للتنقل والرسوم المتحركة.

تصدير العروض التقديمية إلى XAML في Java