Converters

Internal API — De klassen op deze pagina worden intern gebruikt door de exportpipeline. De meeste ontwikkelaars werken in plaats daarvan met Document.save(). Zie Core Management voor de openbare API.

Aspose.Words FOSS for Python gebruikt gespecialiseerde converterklassen om het interne documentmodel om te zetten naar uitvoerformaten. ParagraphConverter verwerkt tekst en opmaak, TableConverter verwerkt tabelstructuren, en ListHandler beheert lijstopmaak.

Paragraaf Converter

ParagraphConverter transformeert documentparagrafen naar het doeloutputformaat. Het inspecteert alinea‑opmaak, run‑niveau styling en inline‑inhoud.

Methode	Beschrijving
`ParagraphConverter.get_paragraph_info()`	Haal opmaakinformatie uit een alinea
`ParagraphConverter.get_run_formatting()`	Ontvang opmaakdetails voor een tekstrun
`ParagraphConverter.format_text()`	Pas opmaak toe op tekstinhoud

Tabelconverter

TableConverter converteert documenttabellen naar het doelformaat (zoals Markdown‑tabellen).

Methode	Beschrijving
`TableConverter.convert()`	Converteer een tabel‑element naar het uitvoerformaat

Lijsthandler

ListHandler beheert de lijststatus tijdens documentconversie, waarbij de geneste lijsten, markeringen en opmaak worden gevolgd.

Methode	Beschrijving
`ListHandler.set_reader()`	Stel de documentlezer in voor lijstcontext
`ListHandler.reset()`	Reset de lijstvolgstaat
`ListHandler.get_list_info()`	Haal lijstitemdetails op voor een alinea
`ListHandler.format_list_item()`	Formatteer een lijstitem met marker en inspringing
`ListHandler.break_list()`	Signaleer het einde van een lijstsequentie

Tips en best practices

Converters worden intern gebruikt door de exportpipeline — de meeste ontwikkelaars werken in plaats daarvan met Document.save()
ParagraphConverter.format_text() respecteert de context van codeblokken om te voorkomen dat inline‑opmaak wordt toegepast binnen code‑spans
ListHandler behoudt de status over opeenvolgende lijstparagrafen — roep reset() aan bij het starten van een nieuw documentgedeelte

Veelvoorkomende problemen

Probleem	Oorzaak	Oplossing
Niet‑uitgelijnde tabelkolommen	Invoertabel heeft samengevoegde cellen	`TableConverter` verwerkt eenvoudige tabellen; samengevoegde cellen kunnen onverwachte output veroorzaken
Defecte lijstnummering	Lijststatus wordt niet gereset tussen secties	Roep `ListHandler.reset()` aan bij sectiegrenzen

API Referentie Samenvatting

Klasse / Methode	Beschrijving
`ParagraphConverter.get_paragraph_info()`	Paragraafopmaak extraheren
`ParagraphConverter.get_run_formatting()`	Run-niveau opmaak ophalen
`ParagraphConverter.format_text()`	Opmaak toepassen op tekst
`TableConverter.convert()`	Een tabel converteren naar uitvoerformaat
`ListHandler.set_reader()`	Documentlezercontext instellen
`ListHandler.get_list_info()`	Lijstitemdetails ophalen
`ListHandler.format_list_item()`	Een lijstitem opmaken