Com convertir documents amb classes de convertidor a Python

Com convertir documents amb classes de convertidor

Aspose.Words FOSS for Python utilitza classes de convertidor internes durant l’exportació de documents. Tot i que la majoria d’usuaris interactua amb Document.save(), comprendre les classes de convertidor és útil per a escenaris avançats.

Requisits previs

Instal·la la biblioteca:

pip install aspose-words-foss>=26.4.0

Requereix Python 3.10 o posterior.

ParagraphConverter

ParagraphConverter transforma els paràgrafs del document al format de sortida de destinació. Mètodes clau:

• ParagraphConverter.get_paragraph_info() — extreure informació de format d’un paràgraf
• ParagraphConverter.get_run_formatting() — obtenir format per a un fragment de text
• ParagraphConverter.format_text() — aplicar format al contingut del text

TableConverter

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

• TableConverter.convert() — convertir un element de taula al format de sortida

ListHandler

ListHandler gestiona l’estat de la llista durant la conversió:

• ListHandler.set_reader() — establir el context del lector de documents
• ListHandler.reset() — restablir l’estat de seguiment de la llista
• ListHandler.get_list_info() — obtenir detalls de l’element de llista per a un paràgraf
• ListHandler.format_list_item() — formatar un element de llista amb marcador i sagnia
• ListHandler.break_list() — senyalitzar el final d’una seqüència de llista

Exemple de conversió ràpida

Per a la majoria dels casos d’ús, utilitzeu Document.save() directament — les classes convertidores s’invoquen automàticament:

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf", aw.SaveFormat.PDF)

Resum