Convertoare

Conversori

Aspose.Words FOSS for Python folosește clase de convertor specializate pentru a transforma modelul intern al documentului în formatele de ieșire. ParagraphConverter gestionează textul și formatarea, TableConverter gestionează structurile de tabel și ListHandler administrează formatarea listelor.

Convertor de paragrafe

ParagraphConverter transformă paragrafele documentului în formatul de ieșire țintă. Verifică formatarea paragrafelor, run-level styling și inline content.

Metodă	Descriere
`ParagraphConverter.get_paragraph_info()`	Extrage informațiile de formatare dintr-un paragraf
`ParagraphConverter.get_run_formatting()`	Obține detalii de formatare pentru o secvență de text
`ParagraphConverter.format_text()`	Aplică formatarea la conținutul textului

Convertor de tabele

TableConverter convertește tabelele documentului în formatul țintă (cum ar fi tabelele Markdown).

Metodă	Descriere
`TableConverter.convert()`	Convertește un element de tabel în formatul de ieșire

Gestionar de listă

ListHandler gestionează starea listelor în timpul conversiei documentului, urmărind imbricarea listelor, marcatorii și formatarea.

Metodă	Descriere
`ListHandler.set_reader()`	Setează cititorul de document pentru contextul listei
`ListHandler.reset()`	Resetează starea de urmărire a listei
`ListHandler.get_list_info()`	Obține detaliile elementului de listă pentru un paragraf
`ListHandler.format_list_item()`	Formatează un element de listă cu marcator și indentare
`ListHandler.break_list()`	Semnalizează sfârșitul unei secvențe de listă

Sfaturi și cele mai bune practici

Conversoarele sunt utilizate intern de către pipeline‑ul de export — majoritatea dezvoltatorilor interacționează cu Document.save() în schimb
ParagraphConverter.format_text() respectă contextul blocului de cod pentru a evita aplicarea formatării inline în interiorul segmentelor de cod
ListHandler menține starea pe parcursul paragrafelor de listă consecutive — apelaţi reset() când începeţi o nouă secţiune de document

Probleme comune

Problemă	Cauză	Remediere
Coloane de tabel nealiniate	Tabelul de intrare are celule fuzionate	`TableConverter` gestionează tabele simple; celulele fuzionate pot produce rezultate neașteptate
Numerotare de listă întreruptă	Starea listei nu este resetată între secțiuni	Apelă `ListHandler.reset()` la limitele secțiunilor

Sumar referință API

Clasă / Metodă	Descriere
`ParagraphConverter.get_paragraph_info()`	Extrage formatarea paragrafului
`ParagraphConverter.get_run_formatting()`	Obține formatarea la nivel de run
`ParagraphConverter.format_text()`	Aplică formatarea la text
`TableConverter.convert()`	Convertește un tabel în formatul de ieșire
`ListHandler.set_reader()`	Setează contextul cititorului de document
`ListHandler.get_list_info()`	Obține detaliile elementului de listă
`ListHandler.format_list_item()`	Formatează un element de listă