محولات

المحولات

Internal API — الفئات في هذه الصفحة تُستخدم داخليًا بواسطة خط أنابيب التصدير. يتفاعل معظم المطورين مع Document.save() بدلاً من ذلك. راجع Core Management للحصول على واجهة برمجة التطبيقات العامة.

يستخدم Aspose.Words FOSS for Python فئات محول متخصصة لتحويل نموذج المستند الداخلي إلى صيغ الإخراج. ParagraphConverter يتعامل مع النص والتنسيق، TableConverter يتعامل مع هياكل الجداول، وListHandler يدير تنسيق القوائم.

محول الفقرات

ParagraphConverter يحول فقرات المستند إلى تنسيق الإخراج المستهدف. يقوم بفحص تنسيق الفقرة، وتنسيق المستوى التشغيلي، والمحتوى المضمن.

الطريقة	الوصف
`ParagraphConverter.get_paragraph_info()`	استخراج معلومات التنسيق من فقرة
`ParagraphConverter.get_run_formatting()`	الحصول على تفاصيل التنسيق لتشغيل النص
`ParagraphConverter.format_text()`	تطبيق التنسيق على محتوى النص

محول الجداول

TableConverter يحول جداول المستند إلى الصيغة المستهدفة (مثل جداول Markdown).

الطريقة	الوصف
`TableConverter.convert()`	تحويل عنصر جدول إلى تنسيق الإخراج

معالج القائمة

ListHandler يدير حالة القوائم أثناء تحويل المستند، ويتتبع تعشيق القوائم والعلامات والتنسيق.

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

نصائح وأفضل الممارسات

يتم استخدام المحولات داخليًا بواسطة خط أنابيب التصدير — يتفاعل معظم المطورين مع Document.save() بدلاً من ذلك
ParagraphConverter.format_text() يحترم سياق كتلة الشيفرة لتجنب تطبيق التنسيق المضمن داخل مقاطع الشيفرة
ListHandler يحافظ على الحالة عبر فقرات القوائم المتتالية — استدعِ reset() عند بدء قسم جديد من المستند

المشكلات الشائعة

المشكلة	السبب	الإصلاح
أعمدة الجدول غير محاذاة	الجدول المدخل يحتوي على خلايا مدمجة	`TableConverter` يتعامل مع الجداول البسيطة؛ قد تؤدي الخلايا المدمجة إلى مخرجات غير متوقعة
ترقيم القوائم معطوب	حالة القائمة لم تُعاد ضبطها بين الأقسام	استدعِ `ListHandler.reset()` عند حدود الأقسام

ملخص مرجع API

الفئة / الطريقة	الوصف
`ParagraphConverter.get_paragraph_info()`	استخراج تنسيق الفقرة
`ParagraphConverter.get_run_formatting()`	الحصول على تنسيق مستوى التشغيل
`ParagraphConverter.format_text()`	تطبيق التنسيق على النص
`TableConverter.convert()`	تحويل جدول إلى تنسيق الإخراج
`ListHandler.set_reader()`	تعيين سياق قارئ المستند
`ListHandler.get_list_info()`	الحصول على تفاصيل عنصر القائمة
`ListHandler.format_list_item()`	تنسيق عنصر القائمة