Konvertory

Internal API — Třídy na této stránce jsou používány interně exportním potrubím. Většina vývojářů místo toho pracuje s Document.save(). Viz Core Management pro veřejné API.

Aspose.Words FOSS for Python používá specializované konvertovací třídy k transformaci interního modelu dokumentu do výstupních formátů. ParagraphConverter zpracovává text a formátování, TableConverter zpracovává struktury tabulek a ListHandler spravuje formátování seznamů.

Převodník odstavců

ParagraphConverter převádí odstavce dokumentu do cílového výstupního formátu. Kontroluje formátování odstavců, stylování na úrovni běhu a vložený obsah.

Metoda	Popis
`ParagraphConverter.get_paragraph_info()`	Extrahovat informace o formátování z odstavce
`ParagraphConverter.get_run_formatting()`	Získat podrobnosti o formátování textového úseku
`ParagraphConverter.format_text()`	Použít formátování na textový obsah

Převodník tabulek

TableConverter převádí tabulky dokumentu do cílového formátu (například Markdown tabulky).

Metoda	Popis
`TableConverter.convert()`	Převést prvek tabulky do výstupního formátu

Správce seznamu

ListHandler spravuje stav seznamu během konverze dokumentu, sleduje vnoření seznamů, značky a formátování.

Metoda	Popis
`ListHandler.set_reader()`	Nastavit čtečku dokumentu pro kontext seznamu
`ListHandler.reset()`	Resetovat stav sledování seznamu
`ListHandler.get_list_info()`	Získat podrobnosti položky seznamu pro odstavec
`ListHandler.format_list_item()`	Formátovat položku seznamu s označením a odsazením
`ListHandler.break_list()`	Signalizovat konec sekvence seznamu

Tipy a osvědčené postupy

Konvertory jsou používány interně exportním potrubím — většina vývojářů místo toho pracuje s Document.save()
ParagraphConverter.format_text() respektuje kontext bloků kódu, aby se zabránilo aplikaci inline formátování uvnitř úseků kódu
ListHandler udržuje stav napříč po sobě jdoucími odstavci seznamu — zavolejte reset() při zahájení nové sekce dokumentu

Časté problémy

Problém	Příčina	Oprava
Nesprávně zarovnané sloupce tabulky	Vstupní tabulka má sloučené buňky	`TableConverter` zpracovává jednoduché tabulky; sloučené buňky mohou způsobit neočekávaný výstup
Poškozené číslování seznamu	Stav seznamu není resetován mezi sekcemi	Zavolejte `ListHandler.reset()` na hranicích sekcí

Souhrn referenčního API

Třída / Metoda	Popis
`ParagraphConverter.get_paragraph_info()`	Extrahovat formátování odstavce
`ParagraphConverter.get_run_formatting()`	Získat formátování na úrovni běhu
`ParagraphConverter.format_text()`	Použít formátování na text
`TableConverter.convert()`	Převést tabulku do výstupního formátu
`ListHandler.set_reader()`	Nastavit kontext čtečky dokumentu
`ListHandler.get_list_info()`	Získat podrobnosti položky seznamu
`ListHandler.format_list_item()`	Formátovat položku seznamu