Konvertory

Aspose.Words FOSS for Python používa špecializované konverzné triedy na transformáciu interného modelu dokumentu do výstupných formátov. ParagraphConverter spracováva text a formátovanie, TableConverter spracováva štruktúry tabuliek a ListHandler spravuje formátovanie zoznamov.

Konvertor odsekov

ParagraphConverter transformuje odseky dokumentu do cieľového výstupného formátu. Kontroluje formátovanie odsekov, štýlovanie na úrovni bežiaceho textu a vložený obsah.

Metóda	Popis
`ParagraphConverter.get_paragraph_info()`	Extrahovať informácie o formátovaní z odseku
`ParagraphConverter.get_run_formatting()`	Získať podrobnosti o formátovaní pre úsek textu
`ParagraphConverter.format_text()`	Použiť formátovanie na textový obsah

Konvertor tabuliek

TableConverter konvertuje tabuľky dokumentu do cieľového formátu (napríklad Markdown tabuľky).

Metóda	Popis
`TableConverter.convert()`	Previesť prvok tabuľky do výstupného formátu

Zoznamový manipulátor

ListHandler spravuje stav zoznamu počas konverzie dokumentu, sleduje vnorenie zoznamov, značky a formátovanie.

Metóda	Popis
`ListHandler.set_reader()`	Nastaviť čítač dokumentu pre kontext zoznamu
`ListHandler.reset()`	Resetovať stav sledovania zoznamu
`ListHandler.get_list_info()`	Získať podrobnosti položky zoznamu pre odsek
`ListHandler.format_list_item()`	Formátovať položku zoznamu so značkou a odsadením
`ListHandler.break_list()`	Signalizovať koniec sekvencie zoznamu

Tipy a osvedčené postupy

Konvertory sa používajú interne v exportnom potrubí — väčšina vývojárov pracuje namiesto toho s Document.save()
ParagraphConverter.format_text() rešpektuje kontext kódu blokov, aby sa predišlo použitiu inline formátovania v rámci kódových úsekov
ListHandler udržiava stav naprieč po sebe idúcimi odsekmi zoznamu — zavolajte reset() pri začatí novej sekcie dokumentu

Bežné problémy

Problém	Príčina	Oprava
Nesprávne zarovnané stĺpce tabuľky	Vstupná tabuľka má zlúčené bunky	`TableConverter` spracováva jednoduché tabuľky; zlúčené bunky môžu spôsobiť neočakávaný výstup
Poškodené číslovanie zoznamu	Stav zoznamu sa neobnovuje medzi sekciami	Zavolajte `ListHandler.reset()` na hraniciach sekcií

Zhrnutie referencie API

Trieda / Metóda	Popis
`ParagraphConverter.get_paragraph_info()`	Extrahovať formátovanie odseku
`ParagraphConverter.get_run_formatting()`	Získať formátovanie úrovne spustenia
`ParagraphConverter.format_text()`	Použiť formátovanie na text
`TableConverter.convert()`	Previesť tabuľku do výstupného formátu
`ListHandler.set_reader()`	Nastaviť kontext čítača dokumentu
`ListHandler.get_list_info()`	Získať podrobnosti položky zoznamu
`ListHandler.format_list_item()`	Formátovať položku zoznamu