Convertisseurs

API interne — Les classes sur cette page sont utilisées en interne par le pipeline d’exportation. La plupart des développeurs interagissent avec Document.save() à la place. Voir Gestion du cœur pour l’API publique.

Aspose.Words FOSS for Python utilise des classes de convertisseur spécialisées pour transformer le modèle de document interne en formats de sortie. ParagraphConverter gère le texte et le formatage, TableConverter gère les structures de tableau, et ListHandler gère le formatage des listes.

Convertisseur de paragraphes

ParagraphConverter transforme les paragraphes du document en format de sortie cible. Il examine le formatage des paragraphes, le style au niveau des runs et le contenu en ligne.

Méthode	Description
`ParagraphConverter.get_paragraph_info()`	Extraire les informations de mise en forme d’un paragraphe
`ParagraphConverter.get_run_formatting()`	Obtenir les détails de mise en forme d’un run de texte
`ParagraphConverter.format_text()`	Appliquer la mise en forme au contenu texte

Convertisseur de tableau

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

Méthode	Description
`TableConverter.convert()`	Convertir un élément de tableau au format de sortie

Gestionnaire de liste

ListHandler gère l’état des listes pendant la conversion de documents, en suivant l’imbrication des listes, les marqueurs et le formatage.

Méthode	Description
`ListHandler.set_reader()`	Définir le lecteur de document pour le contexte de liste
`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

Conseils et meilleures pratiques

Les convertisseurs sont utilisés en interne par le pipeline d’exportation — la plupart des développeurs interagissent avec Document.save() à la place
ParagraphConverter.format_text() respecte le contexte des blocs de code afin d’éviter d’appliquer un formatage en ligne à l’intérieur des spans de code
ListHandler maintient l’état entre les paragraphes de listes consécutifs — appelez reset() lors du démarrage d’une nouvelle section de document

Problèmes courants

Problème	Cause	Correction
Colonnes de tableau mal alignées	Le tableau d’entrée possède des cellules fusionnées	`TableConverter` gère les tableaux simples ; les cellules fusionnées peuvent produire une sortie inattendue
Numérotation de liste cassée	L’état de la liste n’est pas réinitialisé entre les sections	Appelez `ListHandler.reset()` aux limites de section

Résumé de la référence API

Classe / Méthode	Description
`ParagraphConverter.get_paragraph_info()`	Extraire le formatage du paragraphe
`ParagraphConverter.get_run_formatting()`	Obtenir le formatage au niveau du run
`ParagraphConverter.format_text()`	Appliquer le formatage au texte
`TableConverter.convert()`	Convertir un tableau au format de sortie
`ListHandler.set_reader()`	Définir le contexte du lecteur de document
`ListHandler.get_list_info()`	Obtenir les détails de l’élément de liste
`ListHandler.format_list_item()`	Formater un élément de liste