Μετατροπείς

Το 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()`	Λήψη μορφοποίησης σε επίπεδο run
`ParagraphConverter.format_text()`	Εφαρμογή μορφοποίησης στο κείμενο
`TableConverter.convert()`	Μετατροπή πίνακα σε μορφή εξόδου
`ListHandler.set_reader()`	Ορισμός πλαισίου ανάγνωσης εγγράφου
`ListHandler.get_list_info()`	Λήψη λεπτομερειών στοιχείου λίστας
`ListHandler.format_list_item()`	Μορφοποίηση στοιχείου λίστας