Comment convertir des documents avec les classes de convertisseur en Python

Comment convertir des documents avec des classes de convertisseur

Aspose.Words FOSS for Python utilise des classes de convertisseur internes lors de l’exportation de documents. Bien que la plupart des utilisateurs interagissent avec Document.save(), comprendre les classes de convertisseur est utile pour les scénarios avancés.

Prérequis

Installez la bibliothèque :

pip install aspose-words-foss>=26.4.0

Nécessite Python 3.10 ou version ultérieure.

ParagraphConverter

ParagraphConverter transforme les paragraphes du document en format de sortie cible. Méthodes clés :

• ParagraphConverter.get_paragraph_info() — extraire les informations de mise en forme d’un paragraphe
• ParagraphConverter.get_run_formatting() — obtenir la mise en forme d’un run de texte
• ParagraphConverter.format_text() — appliquer la mise en forme au contenu texte

TableConverter

TableConverter convertit les tableaux de documents au format cible (tel que les tableaux Markdown) :

• TableConverter.convert() — convertir un élément de tableau au format de sortie

ListHandler

ListHandler gère l’état de la liste pendant la conversion :

• ListHandler.set_reader() — définir le contexte du lecteur de document
• ListHandler.reset() — réinitialiser l’état de suivi de la liste
• ListHandler.get_list_info() — obtenir les détails de l’élément de liste pour un paragraphe
• ListHandler.format_list_item() — formater un élément de liste avec le marqueur et l’indentation
• ListHandler.break_list() — signaler la fin d’une séquence de liste

Exemple de conversion rapide

Pour la plupart des cas d’utilisation, utilisez Document.save() directement — les classes de conversion sont invoquées automatiquement :

import aspose.words_foss as aw

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

Résumé