Muuntaimet

Muuntimet

Internal API — Tällä sivulla olevia luokkia käytetään sisäisesti vientiputkessa. Useimmat kehittäjät käyttävät sen sijaan Document.save(). Katso Core Management julkisesta API:sta.

Aspose.Words FOSS for Python käyttää erikoistuneita muunnosluokkia muuntaakseen sisäisen asiakirjamallin lähtömuotoihin. ParagraphConverter käsittelee tekstiä ja muotoilua, TableConverter käsittelee taulukkorakenteita, ja ListHandler hallinnoi luettelomuotoilua.

Kappaleen muunnin

ParagraphConverter muuntaa asiakirjan kappaleet kohdeulostusmuotoon. Se tarkastelee kappaleen muotoilua, run‑tason tyyliä ja sisäkkäistä sisältöä.

Menetelmä	Kuvaus
`ParagraphConverter.get_paragraph_info()`	Poimi muotoilutiedot kappaleesta
`ParagraphConverter.get_run_formatting()`	Hae muotoilutiedot tekstijonolle
`ParagraphConverter.format_text()`	Käytä muotoilua tekstisisältöön

Taulukkomuunnin

TableConverter muuntaa asiakirjan taulukot kohdeformaattiin (kuten Markdown-taulukot).

Menetelmä	Kuvaus
`TableConverter.convert()`	Muunna taulukkoelementti lähtömuotoon

Listan käsittelijä

ListHandler hallinnoi luettelon tilaa asiakirjan muunnoksen aikana, seuraten luettelon sisäkkäisyyttä, merkkejä ja muotoilua.

Menetelmä	Kuvaus
`ListHandler.set_reader()`	Aseta asiakirjanlukija luettelokontekstiin
`ListHandler.reset()`	Nollaa luettelon seurannan tila
`ListHandler.get_list_info()`	Hae luettelokohteen tiedot kappaleelle
`ListHandler.format_list_item()`	Muotoile luettelokohde merkinnällä ja sisennyksellä
`ListHandler.break_list()`	Ilmoita luettelosekvenssin loppu

Vinkkejä ja parhaita käytäntöjä

Muuntimia käytetään sisäisesti vientiputkessa — suurin osa kehittäjistä on vuorovaikutuksessa Document.save():n kanssa sen sijaan
ParagraphConverter.format_text() kunnioittaa koodilohkon kontekstia välttääkseen sisäkkäisen muotoilun soveltamista koodiväleihin
ListHandler ylläpitää tilaa peräkkäisissä luettelokappaleissa — kutsu reset() kun aloitat uuden asiakirjan osion

Yleiset ongelmat

Ongelma	Syy	Korjaus
Epälinjaiset taulukon sarakkeet	Syötetaulukossa on yhdistettyjä soluja	`TableConverter` käsittelee yksinkertaisia taulukoita; yhdistetyt solut voivat aiheuttaa odottamattoman tuloksen
Rikkinäinen luettelon numerointi	Luettelon tila ei nollaa osioiden välillä	Kutsu `ListHandler.reset()` osioiden rajoilla

API-viitteiden yhteenveto

Luokka / Metodi	Kuvaus
`ParagraphConverter.get_paragraph_info()`	Poimi kappaleen muotoilu
`ParagraphConverter.get_run_formatting()`	Hae run-tason muotoilu
`ParagraphConverter.format_text()`	Käytä muotoilua tekstiin
`TableConverter.convert()`	Muunna taulukko tulostusmuotoon
`ListHandler.set_reader()`	Aseta asiakirjan lukijan konteksti
`ListHandler.get_list_info()`	Hae luettelokohdan tiedot
`ListHandler.format_list_item()`	Muotoile luettelokohde