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

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

تصدير PowerPoint إلى markdown يكون بدون صور بشكل افتراضي. إذا أردت تصدير مستند PowerPoint يحتوي على صور، تحتاج إلى ضبط markdownSaveOptions.setExportType(MarkdownExportType.Visual) وأيضًا تحديد BasePath حيث سيتم حفظ الصور المشار إليها في مستند markdown.

تحويل PowerPoint إلى Markdown

1. إنشاء مثيل من فئة Presentation لتمثيل كائن عرض تقديمي.
2. استخدام طريقة Save لحفظ الكائن كملف markdown.

هذا الكود Java يوضح لك كيفية تحويل PowerPoint إلى markdown:

Presentation pres = new Presentation("pres.pptx");
try {
    pres.save("pres.md", SaveFormat.Md);
} finally {
    if (pres != null) pres.dispose();
}

تحويل PowerPoint إلى نمط Markdown

يتيح Aspose.Slides لك تحويل PowerPoint إلى markdown (الذي يحتوي على الصياغة الأساسية)، CommonMark، GitHub flavored markdown، Trello، XWiki، GitLab، و 17 نمطًا آخرًا من markdown.

هذا الكود Java يوضح لك كيفية تحويل PowerPoint إلى CommonMark:

Presentation pres = new Presentation("pres.pptx");
try {
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setFlavor(Flavor.CommonMark);
    pres.save("pres.md", SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}

الـ23 نمط markdown المدعومة مُدرجة في تعداد Flavor من فئة MarkdownSaveOptions.

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

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

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

إذا أردت أن تظهر الصور بشكل منفرد واحدةً تلو الأخرى في markdown الناتج، يجب اختيار الخيار المتسلسل. هذا الكود Java يوضح لك كيفية تحويل عرض تقديمي يحتوي على صور إلى markdown:

Presentation pres = new Presentation("pres.pptx");
try {
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setShowHiddenSlides(true);
    markdownSaveOptions.setShowSlideNumber(true);
    markdownSaveOptions.setFlavor(Flavor.Github);
    markdownSaveOptions.setExportType(MarkdownExportType.Sequential);
    markdownSaveOptions.setNewLineType(NewLineType.Windows);
    pres.save("doc.md", new int[] { 1, 2, 3, 4, 5, 6, 7, 8, 9 }, SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}

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

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

هذا الكود Java يوضح العملية:

Presentation pres = new Presentation("pres.pptx");
try {
    final String outPath = "c:/documents";
    MarkdownSaveOptions markdownSaveOptions = new MarkdownSaveOptions();
    markdownSaveOptions.setExportType(MarkdownExportType.Visual);
    markdownSaveOptions.setImagesSaveFolderName("md-images");
    markdownSaveOptions.setBasePath(outPath);
    pres.save("pres.md", SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) pres.dispose();
}

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

هل تحتفظ الروابط التشعبية أثناء التصدير إلى Markdown؟

نعم. يتم الحفاظ على نص hyperlinks كروابط Markdown قياسية. لا يتم تحويل transitions وanimations الخاصة بالشرائح.

هل يمكنني تسريع التحويل بتشغيله في عدة خيوط؟

يمكنك تنفيذ التحويل بالتوازي عبر الملفات، ولكن لا يجب لا تشارك نفس مثيل Presentation عبر الخيوط. استخدم مثيلات/عمليات منفصلة لكل ملف لتجنب التعارض.

ماذا يحدث للصور—أين يتم حفظها، وهل المسارات نسبية؟

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