Cómo convertir documentos con clases convertidoras en Python

Cómo convertir documentos con clases convertidoras

Aspose.Words FOSS for Python utiliza clases de conversión internas durante la exportación de documentos. Aunque la mayoría de los usuarios interactúan con Document.save(), comprender las clases de conversión es útil para escenarios avanzados.

Requisitos

Instale la biblioteca:

pip install aspose-words-foss>=26.4.0

Requiere Python 3.10 o posterior.

ParagraphConverter

ParagraphConverter transforma los párrafos del documento al formato de salida objetivo. Métodos clave:

• ParagraphConverter.get_paragraph_info() — extraer información de formato de un párrafo
• ParagraphConverter.get_run_formatting() — obtener formato para una ejecución de texto
• ParagraphConverter.format_text() — aplicar formato al contenido de texto

Convertidor de tablas

TableConverter convierte tablas de documentos al formato de destino (como tablas Markdown):

• TableConverter.convert() — convertir un elemento de tabla al formato de salida

ListHandler

ListHandler gestiona el estado de la lista durante la conversión:

• ListHandler.set_reader() — establecer el contexto del lector de documentos
• ListHandler.reset() — restablecer el estado de seguimiento de la lista
• ListHandler.get_list_info() — obtener los detalles del elemento de lista para un párrafo
• ListHandler.format_list_item() — formatear un elemento de lista con marcador e indentación
• ListHandler.break_list() — señalar el final de una secuencia de lista

Ejemplo rápido de conversión

Para la mayoría de los casos de uso, use Document.save() directamente — las clases convertidoras se invocan automáticamente:

import aspose.words_foss as aw

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

Resumen