Konvertere

Intern API — Klassene på denne siden brukes internt av eksportpipeline. De fleste utviklere samhandler med Document.save() i stedet. Se Core Management for den offentlige API-en.

Aspose.Words FOSS for Python bruker spesialiserte konverteringsklasser for å transformere den interne dokumentmodellen til utdataformater. ParagraphConverter håndterer tekst og formatering, TableConverter håndterer tabellstrukturer, og ListHandler administrerer listeformatering.

Avsnittkonverterer

ParagraphConverter transformerer dokumentparagrafer til målutdataformatet. Den inspiserer paragrafformatering, stil på kjørenivå og inline‑innhold.

Metode	Beskrivelse
`ParagraphConverter.get_paragraph_info()`	Uttrekk formateringsinformasjon fra et avsnitt
`ParagraphConverter.get_run_formatting()`	Hent formateringsdetaljer for en tekstkjøring
`ParagraphConverter.format_text()`	Bruk formatering på tekstinnhold

Tabellkonverterer

TableConverter konverterer dokumenttabeller til målformatet (for eksempel Markdown‑tabeller).

Metode	Beskrivelse
`TableConverter.convert()`	Konverter et tabell-element til utdataformatet

Listebehandler

ListHandler håndterer listestatus under dokumentkonvertering, sporer listenesting, markører og formatering.

Metode	Beskrivelse
`ListHandler.set_reader()`	Angi dokumentleseren for listekontekst
`ListHandler.reset()`	Tilbakestill liste‑sporingsstatus
`ListHandler.get_list_info()`	Hent listeelementdetaljer for et avsnitt
`ListHandler.format_list_item()`	Formater et listeelement med markør og innrykk
`ListHandler.break_list()`	Signaliser slutten på en listesekvens

Tips og beste praksis

Konverterere brukes internt av eksport‑pipeline — de fleste utviklere samhandler med Document.save() i stedet
ParagraphConverter.format_text() respekterer kodeblokk‑konteksten for å unngå å bruke innlinjet formatering inne i kodeområder
ListHandler opprettholder tilstand på tvers av påfølgende listeavsnitt — kall reset() når du starter en ny dokumentseksjon

Vanlige problemer

Problem	Årsak	Løsning
Feiljusterte tabellkolonner	Inndata-tabellen har flettede celler	`TableConverter` håndterer enkle tabeller; flettede celler kan gi uventet output
Ødelagt liste-nummerering	Liste-tilstanden blir ikke tilbakestilt mellom seksjoner	Kall `ListHandler.reset()` ved seksjonsgrenser

API-referansesammendrag

Klasse / Metode	Beskrivelse
`ParagraphConverter.get_paragraph_info()`	Ekstraher avsnittsformatering
`ParagraphConverter.get_run_formatting()`	Hent formatering på kjørenivå
`ParagraphConverter.format_text()`	Bruk formatering på tekst
`TableConverter.convert()`	Konverter en tabell til utdataformat
`ListHandler.set_reader()`	Angi dokumentleser‑kontekst
`ListHandler.get_list_info()`	Hent detaljer for listeelement
`ListHandler.format_list_item()`	Formater et listeelement