Konvertētāji

Iekšējā API — Šīs lapas klases tiek izmantotas iekšēji eksportēšanas caurulē. Lielākā daļa izstrādātāju mijiedarbojas ar Document.save(). Skatiet Core Management publiskajai API.

Aspose.Words FOSS for Python izmanto specializētas konvertera klases, lai pārveidotu iekšējo dokumenta modeli uz izvades formātiem. ParagraphConverter apstrādā tekstu un formatēšanu, TableConverter apstrādā tabulu struktūras, un ListHandler pārvalda sarakstu formatēšanu.

Rindkopas pārveidotājs

ParagraphConverter pārveido dokumenta rindkopas uz mērķa izvades formātu. Tas pārbauda rindkopas formatējumu, izpildes līmeņa stilizāciju un iekļauto saturu.

Metode	Apraksts
`ParagraphConverter.get_paragraph_info()`	Izgūt formatēšanas informāciju no rindkopas
`ParagraphConverter.get_run_formatting()`	Iegūt formatēšanas detaļas teksta fragmentam
`ParagraphConverter.format_text()`	Pielietot formatēšanu teksta saturam

Tabulu pārveidotājs

TableConverter pārveido dokumenta tabulas mērķa formātā (piemēram, Markdown tabulas).

Metode	Apraksts
`TableConverter.convert()`	Pārveidot tabulas elementu uz izvades formātu

Saraksta apstrādātājs

ListHandler pārvalda saraksta stāvokli dokumenta konvertēšanas laikā, izsekot saraksta ligzdošanu, marķierus un formatēšanu.

Metode	Apraksts
`ListHandler.set_reader()`	Iestatīt dokumenta lasītāju saraksta kontekstam
`ListHandler.reset()`	Atiestatīt saraksta izsekošanas stāvokli
`ListHandler.get_list_info()`	Iegūt saraksta vienuma detaļas rindkopai
`ListHandler.format_list_item()`	Formatēt saraksta vienumu ar marķieri un atkāpi
`ListHandler.break_list()`	Signalizēt saraksta secības beigas

Padomi un labākās prakses

Konvertētāji tiek izmantoti iekšēji eksporta caurulē — vairums izstrādātāju mijiedarbojas ar Document.save()
ParagraphConverter.format_text() ņem vērā koda bloka kontekstu, lai izvairītos no iekļaušanas formatēšanas koda fragmentos
ListHandler saglabā stāvokli starp secīgiem saraksta paragrāfiem — izsauc reset(), sākot jaunu dokumenta sadaļu

Biežāk sastopamās problēmas

Problēma	Iemesls	Labojums
Nesaskaņoti tabulas kolonnas	Ievades tabulā ir apvienotas šūnas	`TableConverter` apstrādā vienkāršas tabulas; apvienotas šūnas var radīt negaidītu izvadi
Saspauzta saraksta numurēšana	Saraksta stāvoklis netiek atiestatīts starp sekcijām	Izsauciet `ListHandler.reset()` sekciju robežās

API atsauces kopsavilkums

Klase / Metode	Apraksts
`ParagraphConverter.get_paragraph_info()`	Izgūt rindkopas formatējumu
`ParagraphConverter.get_run_formatting()`	Iegūt izpildes līmeņa formatējumu
`ParagraphConverter.format_text()`	Pielietot formatējumu tekstam
`TableConverter.convert()`	Pārveidot tabulu uz izvades formātu
`ListHandler.set_reader()`	Iestatīt dokumenta lasītāja kontekstu
`ListHandler.get_list_info()`	Iegūt saraksta elementa detaļas
`ListHandler.format_list_item()`	Formatēt saraksta elementu