Konverteri

Pretvarači

Interni API — Klase na ovoj stranici koriste se interno u izvoznom cjevovodu. Većina programera umjesto toga komunicira s Document.save(). Pogledajte Core Management za javni API.

Aspose.Words FOSS for Python koristi specijalizirane klase pretvarača za transformaciju internog modela dokumenta u izlazne formate. ParagraphConverter obrađuje tekst i formatiranje, TableConverter obrađuje strukture tablica, a ListHandler upravlja formatiranjem popisa.

Pretvarač odlomaka

ParagraphConverter pretvara odlomke dokumenta u ciljani izlazni format. Pregledava formatiranje odlomaka, stiliziranje na razini pokretanja i inline sadržaj.

Metoda	Opis
`ParagraphConverter.get_paragraph_info()`	Izvuci informacije o oblikovanju iz odlomka
`ParagraphConverter.get_run_formatting()`	Dohvati detalje oblikovanja za tekstualni segment
`ParagraphConverter.format_text()`	Primijeni oblikovanje na tekstualni sadržaj

Pretvarač tablica

TableConverter pretvara tablice dokumenta u odabrani format (kao što su Markdown tablice).

Metoda	Opis
`TableConverter.convert()`	Pretvori element tablice u izlazni format

Upravljač popisom

ListHandler upravlja stanjem popisa tijekom pretvorbe dokumenta, prateći ugniježđivanje popisa, oznake i formatiranje.

Metoda	Opis
`ListHandler.set_reader()`	Postavi čitač dokumenta za kontekst popisa
`ListHandler.reset()`	Resetiraj stanje praćenja popisa
`ListHandler.get_list_info()`	Dohvati detalje stavke popisa za odlomak
`ListHandler.format_list_item()`	Oblikuj stavku popisa s oznakom i uvlačenjem
`ListHandler.break_list()`	Signaliziraj kraj sekvence popisa

Savjeti i najbolje prakse

Konverteri se koriste interno u izvoznom cjevovodu — većina programera komunicira s Document.save() umjesto toga
ParagraphConverter.format_text() poštuje kontekst blokova koda kako bi izbjegao primjenu inline formatiranja unutar kodnih spanova
ListHandler održava stanje kroz uzastopne odlomke popisa — pozovite reset() pri započinjanju novog odjeljka dokumenta

Uobičajeni problemi

Problem	Uzrok	Rješenje
Neusklađeni stupci tablice	Ulazna tablica ima spojene ćelije	`TableConverter` obrađuje jednostavne tablice; spojene ćelije mogu proizvesti neočekivani izlaz
Oštećeno numeriranje liste	Stanje liste nije resetirano između odjeljaka	Pozovite `ListHandler.reset()` na granicama odjeljaka

Sažetak API reference

Klasa / Metoda	Opis
`ParagraphConverter.get_paragraph_info()`	Izdvoji formatiranje odlomka
`ParagraphConverter.get_run_formatting()`	Dohvati formatiranje na razini runa
`ParagraphConverter.format_text()`	Primijeni formatiranje na tekst
`TableConverter.convert()`	Pretvori tablicu u izlazni format
`ListHandler.set_reader()`	Postavi kontekst čitača dokumenta
`ListHandler.get_list_info()`	Dohvati detalje stavke popisa
`ListHandler.format_list_item()`	Formatiraj stavku popisa