تحويل عروض PowerPoint إلى Markdown في PHP

نظرة عامة

Aspose.Slides for PHP via Java يتيح تحويل محتوى العروض التقديمية إلى Markdown، مما يسمح لك بإعادة استخدام ملفات PowerPoint (PPT، PPTX) وOpenDocument (ODP) في الويكي، مستودعات Git، ومولدات المواقع الثابتة. تحافظ API على تسلسل الشرائح الهرمي مع إنتاج Markdown خفيف الوزن وسهل القراءة، حتى تتمكن من أتمتة خطوط وثائقك والحفاظ على تزامن العروض الأصلية وملفات Markdown بشكل مثالي.

تم تنفيذ دعم تحويل PowerPoint إلى Markdown في Aspose.Slides 23.7.

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

يوضح هذا القسم كيف يقوم Aspose.Slides بتحويل عروض PowerPoint وOpenDocument (PPT، PPTX، ODP) إلى Markdown نظيف، مع الحفاظ على تسلسل الشرائح الأصلي، النص، والتنسيق الأساسي، بحيث يمكنك إعادة استخدام المحتوى في الوثائق أو عمليات سير العمل التي تُدار عبر نظام التحكم بالإصدارات دون جهد يدوي إضافي.

1. إنشاء نسخة من الفئة Presentation لتمثيل العرض التقديمي.
2. استخدم الطريقة save لتصديره كملف Markdown.

يعرض هذا الكود PHP كيفية تحويل عرض PowerPoint إلى Markdown:

$presentation = new Presentation("presentation.pptx");
try {
    $presentation->save("presentation.md", SaveFormat::Md);
} finally {
    $presentation->dispose();
}

تحويل عرض تقديمي إلى نكهة Markdown

يسمح Aspose.Slides لك بتحويل عروض PowerPoint إلى Markdown باستخدام البنية الأساسية، وكذلك إلى CommonMark، GitHub‑flavored Markdown، Trello، XWiki، GitLab، وسبع عشرة نكهة أخرى من Markdown.

يعرض الكود PHP التالي كيفية تحويل عرض PowerPoint إلى CommonMark:

$presentation = new Presentation("presentation.pptx");
try {
    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setFlavor(Flavor->CommonMark);

    $presentation->save("presentation.md", SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

يتم سرد النكهات الـ23 المدعومة في Flavor enumeration.

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

توفر الفئة MarkdownSaveOptions خصائص وتعدادات تسمح لك بتكوين ملف Markdown الناتج. على سبيل المثال، يحدد تعداد MarkdownExportType كيفية معالجة الصور: Sequential أو TextOnly أو Visual.

بشكل افتراضي، تصدير PowerPoint‑to‑Markdown لا يتضمن الصور. لتضمين الصور، استدعِ markdownSaveOptions.setExportType(MarkdownExportType::Visual) وحدد BasePath الذي يحدد مكان حفظ الصور المشار إليها في ملف Markdown.

تحويل الصور تسلسلياً

إذا كنت ترغب في ظهور الصور بشكل فردي، واحدةً تلو الأخرى، في Markdown الناتج، عليك اختيار الخيار Sequential. يظهر الكود PHP التالي كيفية تحويل عرض يحتوي على صور إلى Markdown:

$presentation = new Presentation("presentation.pptx");
try {
    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setShowHiddenSlides(true);
    $saveOptions->setShowSlideNumber(true);
    $saveOptions->setFlavor(Flavor->Github);
    $saveOptions->setExportType(MarkdownExportType::Sequential);
    $saveOptions->setNewLineType(NewLineType::Windows);

    $slideIndices = array(1, 2, 3, 4);
    $presentation->save("presentation.md", $slideIndices, SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

تحويل الصور بصرياً

إذا كنت تريد ظهور الصور معاً في Markdown الناتج، عليك اختيار الخيار Visual. في هذه الحالة تُحفظ الصور في دليل التطبيق الحالي (ويُولد مسار نسبي لها في مستند Markdown)، أو يمكنك تحديد الدليل والمجلد المفضل لديك.

يعرض الكود PHP التالي عملية التحويل:

$presentation = new Presentation("presentation.pptx");
try {
    $outPath = "c:/documents";

    $saveOptions = new MarkdownSaveOptions();
    $saveOptions->setExportType(MarkdownExportType::Visual);
    $saveOptions->setImagesSaveFolderName("md-images");
    $saveOptions->setBasePath($outPath);

    $presentation->save("presentation.md", SaveFormat::Md, $saveOptions);
} finally {
    $presentation->dispose();
}

الأسئلة المتداولة

هل تبقى الروابط الفائقة (hyperlinks) بعد التصدير إلى Markdown؟
نعم. يتم الحفاظ على روابط النص hyperlinks كروابط Markdown قياسية. لا يتم تحويل انتقالات الشرائح transitions أو الرسوم المتحركة animations.

هل يمكن تسريع التحويل بتشغيله في عدة خيوط (threads)؟
يمكنك تقسيم العمل عبر ملفات متعددة، ولكن لا تُشارك نفس مثيل الفئة Presentation بين الخيوط. استخدم مثيلات/عمليات منفصلة لكل ملف لتجنب التنافس.

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