ממירים

Internal API — המחלקות בדף זה משמשות פנימית בצינור הייצוא. רוב המפתחים מתקשרים עם Document.save() במקום זאת. ראה Core Management עבור ה‑API הציבורי.

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() כאשר מתחילים קטע מסמך חדש

בעיות נפוצות

Issue	Cause	Fix
עמודות טבלה לא מיושרות	טבלת הקלט מכילה תאים ממוזגים	`TableConverter` מטפל בטבלאות פשוטות; תאים ממוזגים עשויים לייצר פלט בלתי צפוי
מספור רשימות פגום	מצב הרשימה לא מתאפס בין חלקים	קרא ל-`ListHandler.reset()` בגבולות החלקים

סיכום תיעוד API

Class / Method	Description
`ParagraphConverter.get_paragraph_info()`	חילוץ עיצוב פסקה
`ParagraphConverter.get_run_formatting()`	קבלת עיצוב ברמת ריצה
`ParagraphConverter.format_text()`	החלת עיצוב על טקסט
`TableConverter.convert()`	המרת טבלה לפורמט פלט
`ListHandler.set_reader()`	הגדרת הקשר קורא המסמך
`ListHandler.get_list_info()`	קבלת פרטי פריט רשימה
`ListHandler.format_list_item()`	עיצוב פריט רשימה