Convertidors

API interna — Les classes d’aquesta pàgina s’utilitzen internament per la canal d’exportació. La majoria dels desenvolupadors interactuen amb Document.save() en canvi. Consulteu Gestió del nucli per a l’API pública.

Aspose.Words FOSS for Python utilitza classes convertidores especialitzades per transformar el model intern del document en formats de sortida. ParagraphConverter gestiona el text i el format, TableConverter gestiona les estructures de taules, i ListHandler gestiona el format de les llistes.

Convertidor de paràgrafs

ParagraphConverter transforma els paràgrafs del document al format de sortida de destinació. Inspecciona el format dels paràgrafs, l’estil a nivell de run i el contingut en línia.

Mètode	Descripció
`ParagraphConverter.get_paragraph_info()`	Extreure informació de format d’un paràgraf
`ParagraphConverter.get_run_formatting()`	Obtenir detalls de format per a una execució de text
`ParagraphConverter.format_text()`	Aplicar format al contingut del text

Convertidor de taules

TableConverter converteix les taules del document al format de destinació (com ara taules Markdown).

Mètode	Descripció
`TableConverter.convert()`	Converteix un element de taula al format de sortida

Gestor de llistes

ListHandler gestiona l’estat de les llistes durant la conversió de documents, fent un seguiment de la nidificació de les llistes, els marcadors i el format.

Mètode	Descripció
`ListHandler.set_reader()`	Estableix el lector de documents per al context de llista
`ListHandler.reset()`	Restableix l’estat de seguiment de la llista
`ListHandler.get_list_info()`	Obté els detalls de l’element de llista per a un paràgraf
`ListHandler.format_list_item()`	Formata un element de llista amb marcador i sagnia
`ListHandler.break_list()`	Segnala la fi d’una seqüència de llista

Consells i bones pràctiques

Els convertidors s’utilitzen internament per la canalització d’exportació — la majoria dels desenvolupadors interactuen amb Document.save() en canvi
ParagraphConverter.format_text() respecta el context del bloc de codi per evitar aplicar formatatge en línia dins d’intervals de codi
ListHandler manté l’estat entre paràgrafs de llista consecutius — crida reset() quan s’inicia una nova secció del document

Problemes comuns

Problema	Causa	Solució
Columnes de taula desalineades	La taula d’entrada té cel·les combinades	`TableConverter` gestiona taules simples; les cel·les combinades poden produir una sortida inesperada
Numeració de llista trencada	L’estat de la llista no es reinicia entre seccions	Crida `ListHandler.reset()` a les fronteres de les seccions

Resum de la referència API

Classe / Mètode	Descripció
`ParagraphConverter.get_paragraph_info()`	Extreu el format del paràgraf
`ParagraphConverter.get_run_formatting()`	Obté el format a nivell de run
`ParagraphConverter.format_text()`	Aplica format al text
`TableConverter.convert()`	Converteix una taula al format de sortida
`ListHandler.set_reader()`	Estableix el context del lector de documents
`ListHandler.get_list_info()`	Obté detalls de l’element de llista
`ListHandler.format_list_item()`	Formata un element de llista