Convertitori

Internal API — Le classi in questa pagina sono utilizzate internamente dal pipeline di esportazione. La maggior parte degli sviluppatori interagisce invece con Document.save(). Vedi Core Management per l’API pubblica.

Aspose.Words FOSS for Python utilizza classi convertitore specializzate per trasformare il modello interno del documento in formati di output. ParagraphConverter gestisce il testo e la formattazione, TableConverter gestisce le strutture delle tabelle e ListHandler gestisce la formattazione delle liste.

Convertitore di paragrafi

ParagraphConverter trasforma i paragrafi del documento nel formato di output di destinazione. Esamina la formattazione dei paragrafi, lo stile a livello di run e il contenuto inline.

Metodo	Descrizione
`ParagraphConverter.get_paragraph_info()`	Estrai le informazioni di formattazione da un paragrafo
`ParagraphConverter.get_run_formatting()`	Ottieni i dettagli di formattazione per un run di testo
`ParagraphConverter.format_text()`	Applica la formattazione al contenuto del testo

Convertitore di tabelle

TableConverter converte le tabelle dei documenti nel formato di destinazione (come le tabelle Markdown).

Metodo	Descrizione
`TableConverter.convert()`	Convertire un elemento tabella nel formato di output

Gestore di elenco

ListHandler gestisce lo stato delle liste durante la conversione del documento, tenendo traccia dell’annidamento delle liste, dei marcatori e della formattazione.

Metodo	Descrizione
`ListHandler.set_reader()`	Imposta il lettore del documento per il contesto dell’elenco
`ListHandler.reset()`	Reimposta lo stato di tracciamento dell’elenco
`ListHandler.get_list_info()`	Ottieni i dettagli dell’elemento di elenco per un paragrafo
`ListHandler.format_list_item()`	Formatta un elemento di elenco con marcatore e rientro
`ListHandler.break_list()`	Segnala la fine di una sequenza di elenco

Suggerimenti e migliori pratiche

I convertitori sono usati internamente dalla pipeline di esportazione — la maggior parte degli sviluppatori interagisce invece con Document.save()
ParagraphConverter.format_text() rispetta il contesto dei blocchi di codice per evitare di applicare formattazione inline all’interno di span di codice
ListHandler mantiene lo stato tra paragrafi di elenco consecutivi — chiamare reset() quando si avvia una nuova sezione del documento

Problemi comuni

Problema	Causa	Correzione
Colonne della tabella non allineate	La tabella di input ha celle unite	`TableConverter` gestisce tabelle semplici; le celle unite possono produrre output inatteso
Numerazione dell’elenco interrotta	Lo stato dell’elenco non viene reimpostato tra le sezioni	Chiama `ListHandler.reset()` ai confini della sezione

Riepilogo della Riferimento API

Classe / Metodo	Descrizione
`ParagraphConverter.get_paragraph_info()`	Estrai la formattazione del paragrafo
`ParagraphConverter.get_run_formatting()`	Ottieni la formattazione a livello di run
`ParagraphConverter.format_text()`	Applica la formattazione al testo
`TableConverter.convert()`	Converti una tabella nel formato di output
`ListHandler.set_reader()`	Imposta il contesto del lettore del documento
`ListHandler.get_list_info()`	Ottieni i dettagli dell’elemento di elenco
`ListHandler.format_list_item()`	Formatta un elemento di elenco