Konverteriai

Internal API — Šio puslapio klasės naudojamos viduje eksporto konvejerio. Dauguma kūrėjų vietoj to sąveikauja su Document.save(). Žr. Core Management dėl viešo API.

Aspose.Words FOSS for Python naudoja specializuotas konvertavimo klases, kad transformuotų vidinį dokumento modelį į išvesties formatus. ParagraphConverter tvarko tekstą ir formatavimą, TableConverter tvarko lentelių struktūras, o ListHandler valdo sąrašo formatavimą.

Pastraipos konverteris

ParagraphConverter transformuoja dokumento pastraipas į tikslinį išvesties formatą. Jis tikrina pastraipos formatavimą, vykdymo lygio stilių ir įterptą turinį.

Metodas	Aprašymas
`ParagraphConverter.get_paragraph_info()`	Išgauti formatavimo informaciją iš pastraipos
`ParagraphConverter.get_run_formatting()`	Gauti formatavimo detales teksto fragmentui
`ParagraphConverter.format_text()`	Taikyti formatavimą teksto turiniui

Lentelių konvertuotojas

TableConverter konvertuoja dokumento lenteles į tikslinį formatą (pvz., Markdown lenteles).

Metodas	Aprašymas
`TableConverter.convert()`	Konvertuoti lentelės elementą į išvesties formatą

Sąrašo tvarkytojas

ListHandler valdo sąrašo būseną konvertuojant dokumentus, sekdamas sąrašo lygiavimą, žymeklius ir formatavimą.

Metodas	Aprašymas
`ListHandler.set_reader()`	Nustatyti dokumento skaitytuvą sąrašo kontekstui
`ListHandler.reset()`	Atstatyti sąrašo sekimo būseną
`ListHandler.get_list_info()`	Gauti sąrašo elemento detales pastraipai
`ListHandler.format_list_item()`	Formatuoti sąrašo elementą su žymekliu ir įtraukimu
`ListHandler.break_list()`	Signalizuoti sąrašo sekos pabaigą

Patarimai ir geriausia praktika

Konverteriai naudojami viduje eksporto konvejerio — dauguma kūrėjų vietoj to naudoja Document.save()
ParagraphConverter.format_text() gerbia kodo bloko kontekstą, kad išvengtų įterptinio formatavimo taikymo kodo segmentuose
ListHandler išlaiko būseną per nuoseklius sąrašo pastraipos — kvieskite reset() pradedant naują dokumento skyrių

Dažnos problemos

Problema	Priežastis	Sprendimas
Nesutampančios lentelės stulpeliai	Įvesties lentelėje yra sujungti langeliai	`TableConverter` apdoroja paprastas lenteles; sujungti langeliai gali sukelti netikėtą išvestį
Sugadintas sąrašo numeravimas	Sąrašo būsena neperkeliama tarp skyrių	Iškvieskite `ListHandler.reset()` skyrių ribose

API nuorodų santrauka

Klasė / Metodas	Aprašymas
`ParagraphConverter.get_paragraph_info()`	Išgauti pastraipos formatavimą
`ParagraphConverter.get_run_formatting()`	Gauti run-level formatavimą
`ParagraphConverter.format_text()`	Taikyti formatavimą tekstui
`TableConverter.convert()`	Konvertuoti lentelę į išvesties formatą
`ListHandler.set_reader()`	Nustatyti dokumento skaitytojo kontekstą
`ListHandler.get_list_info()`	Gauti sąrašo elemento detales
`ListHandler.format_list_item()`	Formatuoti sąrašo elementą