Como Converter Documentos com Classes Conversoras em Python

Como Converter Documentos com Classes de Conversão

Aspose.Words FOSS for Python usa classes de conversor internas durante a exportação de documentos. Enquanto a maioria dos usuários interage com Document.save(), entender as classes de conversor é útil para cenários avançados.

Pré-requisitos

Instale a biblioteca:

pip install aspose-words-foss>=26.4.0

Requer Python 3.10 ou posterior.

ParagraphConverter

ParagraphConverter transforma os parágrafos do documento no formato de saída desejado. Métodos principais:

• ParagraphConverter.get_paragraph_info() — extrair informações de formatação de um parágrafo
• ParagraphConverter.get_run_formatting() — obter formatação de um trecho de texto
• ParagraphConverter.format_text() — aplicar formatação ao conteúdo de texto

TableConverter

TableConverter converte tabelas de documentos para o formato de destino (como tabelas Markdown):

• TableConverter.convert() — converter um elemento de tabela para o formato de saída

ListHandler

ListHandler gerencia o estado da lista durante a conversão:

• ListHandler.set_reader() — definir o contexto do leitor de documento
• ListHandler.reset() — reiniciar o estado de rastreamento da lista
• ListHandler.get_list_info() — obter detalhes do item da lista para um parágrafo
• ListHandler.format_list_item() — formatar um item de lista com marcador e recuo
• ListHandler.break_list() — sinalizar o fim de uma sequência de lista

Exemplo de Conversão Rápida

Para a maioria dos casos de uso, use Document.save() diretamente — as classes conversoras são invocadas automaticamente:

import aspose.words_foss as aw

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

Resumo