كيفية تحويل المستندات باستخدام فئات المحول في بايثون

كيفية تحويل المستندات باستخدام فئات المحول

يستخدم Aspose.Words FOSS for Python فئات محول داخلية أثناء تصدير المستند. بينما يتفاعل معظم المستخدمين مع Document.save()، فإن فهم فئات المحول مفيد للسيناريوهات المتقدمة.

المتطلبات المسبقة

تثبيت المكتبة:

pip install aspose-words-foss>=26.4.0

يتطلب Python 3.10 أو أحدث.

محول الفقرات

ParagraphConverter يحول فقرات المستند إلى تنسيق الإخراج المستهدف. الطرق الرئيسية:

• ParagraphConverter.get_paragraph_info() — استخراج معلومات التنسيق من فقرة
• ParagraphConverter.get_run_formatting() — الحصول على تنسيق لـ text run
• ParagraphConverter.format_text() — تطبيق التنسيق على محتوى النص

TableConverter

TableConverter يحول جداول المستند إلى تنسيق الهدف (مثل جداول Markdown):

• TableConverter.convert() — تحويل عنصر جدول إلى تنسيق الإخراج

ListHandler

ListHandler يدير حالة القائمة أثناء التحويل:

• ListHandler.set_reader() — تعيين سياق قارئ المستند
• ListHandler.reset() — إعادة تعيين حالة تتبع القائمة
• ListHandler.get_list_info() — الحصول على تفاصيل عنصر القائمة لفقرة
• ListHandler.format_list_item() — تنسيق عنصر القائمة مع العلامة والمسافة البادئة
• ListHandler.break_list() — الإشارة إلى نهاية تسلسل القائمة

مثال تحويل سريع

في معظم حالات الاستخدام، استخدم Document.save() مباشرةً — يتم استدعاء فئات المحول تلقائيًا:

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf", aw.SaveFormat.PDF)

ملخص