Konvertere

Intern API — Klasserne på denne side bruges internt af eksportpipeline. De fleste udviklere interagerer i stedet med Document.save(). Se Core Management for den offentlige API.

Aspose.Words FOSS for Python bruger specialiserede konverteringsklasser til at transformere den interne dokumentmodel til outputformater. ParagraphConverter håndterer tekst og formatering, TableConverter håndterer tabelstrukturer, og ListHandler administrerer listeformatering.

Afsnitskonverter

ParagraphConverter transformerer dokumentafsnit til måloutputformatet. Den inspicerer afsnitsformatering, run-level styling og inline-indhold.

Metode	Beskrivelse
`ParagraphConverter.get_paragraph_info()`	Udtræk formateringsinformation fra et afsnit
`ParagraphConverter.get_run_formatting()`	Hent formateringsdetaljer for en tekstkørsel
`ParagraphConverter.format_text()`	Anvend formatering på tekstindhold

Tabelkonverter

TableConverter konverterer dokumenttabeller til målformatet (såsom Markdown-tabeller).

Metode	Beskrivelse
`TableConverter.convert()`	Konverter et tabel-element til outputformatet

Listehåndtering

ListHandler håndterer listetilstand under dokumentkonvertering, sporer listeindlejring, markører og formatering.

Metode	Beskrivelse
`ListHandler.set_reader()`	Indstil dokumentlæseren for listekontekst
`ListHandler.reset()`	Nulstil listesporingsstatus
`ListHandler.get_list_info()`	Hent listeelementdetaljer for et afsnit
`ListHandler.format_list_item()`	Formater et listeelement med markør og indrykning
`ListHandler.break_list()`	Signalér slutningen af en listesekvens

Tips og bedste praksis

Konvertere bruges internt af eksportpipeline — de fleste udviklere interagerer i stedet med Document.save()
ParagraphConverter.format_text() respekterer kodeblok‑kontekst for at undgå at anvende inline‑formatering inden for kode‑spænd
ListHandler bevarer tilstand på tværs af på hinanden følgende liste‑afsnit — kald reset() når du starter en ny dokumentsektion

Almindelige problemer

Problem	Årsag	Løsning
Misdannede tabelkolonner	Indtastningstabel har flettede celler	`TableConverter` håndterer simple tabeller; flettede celler kan give uventet output
Ødelagt listenummerering	Liste-tilstand nulstilles ikke mellem sektioner	Kald `ListHandler.reset()` ved sektionens grænser

API-referencens oversigt

Klasse / Metode	Beskrivelse
`ParagraphConverter.get_paragraph_info()`	Udtræk afsnitsformatering
`ParagraphConverter.get_run_formatting()`	Hent formatering på løbeniveau
`ParagraphConverter.format_text()`	Anvend formatering på tekst
`TableConverter.convert()`	Konverter en tabel til outputformat
`ListHandler.set_reader()`	Indstil dokumentlæserkontekst
`ListHandler.get_list_info()`	Hent detaljer for listeelement
`ListHandler.format_list_item()`	Formater et listeelement