Konverterare

Aspose.Words FOSS for Python använder specialiserade konverterarklasser för att omvandla den interna dokumentmodellen till utdataformat. ParagraphConverter hanterar text och formatering, TableConverter hanterar tabellstrukturer, och ListHandler hanterar listformatering.

Styckeomvandlare

ParagraphConverter omvandlar dokumentparagrafer till målutdataformatet. Den granskar paragrafformatering, körnivåstilning och inline‑innehåll.

Metod	Beskrivning
`ParagraphConverter.get_paragraph_info()`	Extrahera formateringsinformation från ett stycke
`ParagraphConverter.get_run_formatting()`	Hämta formateringsdetaljer för ett textsegment
`ParagraphConverter.format_text()`	Applicera formatering på textinnehåll

Tabellkonverterare

TableConverter konverterar dokumenttabeller till målformatet (t.ex. Markdown‑tabeller).

Metod	Beskrivning
`TableConverter.convert()`	Konvertera ett tabell-element till utdataformatet

Listhanterare

ListHandler hanterar listtillstånd under dokumentkonvertering, spårar listnästning, markörer och formatering.

Metod	Beskrivning
`ListHandler.set_reader()`	Ställ in dokumentläsaren för listkontext
`ListHandler.reset()`	Återställ listspårningstillstånd
`ListHandler.get_list_info()`	Hämta listobjektsdetaljer för ett stycke
`ListHandler.format_list_item()`	Formatera ett listobjekt med markör och indrag
`ListHandler.break_list()`	Signalera slutet på en listsekvens

Tips och bästa praxis

Konverterare används internt av exportpipelines — de flesta utvecklare interagerar med Document.save() istället
ParagraphConverter.format_text() respekterar kodblockskontext för att undvika att tillämpa inline‑formatering inom kodspänn
ListHandler behåller tillstånd över på varandra följande listparagrafer — anropa reset() när du startar ett nytt dokumentavsnitt

Vanliga problem

Problem	Orsak	Åtgärd
Feljusterade tabellkolumner	Indatatabellen har sammanslagna celler	`TableConverter` hanterar enkla tabeller; sammanslagna celler kan ge oväntat resultat
Felaktig listnumrering	Listtillståndet återställs inte mellan sektioner	Anropa `ListHandler.reset()` vid sektionens gränser

API-referenssammanfattning

Klass / Metod	Beskrivning
`ParagraphConverter.get_paragraph_info()`	Extrahera styckeformatering
`ParagraphConverter.get_run_formatting()`	Hämta formatering på körningsnivå
`ParagraphConverter.format_text()`	Tillämpa formatering på text
`TableConverter.convert()`	Konvertera en tabell till utdataformat
`ListHandler.set_reader()`	Ställ in dokumentläsarkontext
`ListHandler.get_list_info()`	Hämta detaljer för listobjekt
`ListHandler.format_list_item()`	Formatera ett listobjekt