Konvertálók

Konverterek

Internal API — Az ezen az oldalon található osztályok belsőleg használatosak az exportcsővezetékben. A legtöbb fejlesztő a Document.save()-val lép kapcsolatba helyette. Lásd a Core Management a nyilvános API-hoz.

Az Aspose.Words FOSS for Python speciális konverter osztályokat használ a belső dokumentummodell kimeneti formátumokká alakításához. ParagraphConverter kezeli a szöveget és a formázást, TableConverter kezeli a táblázatszerkezeteket, és ListHandler kezeli a listák formázását.

Bekezdés konvertáló

ParagraphConverter átalakítja a dokumentum bekezdéseit a célkimeneti formátumba. Ellenőrzi a bekezdésformázást, a futtatási szintű stílusokat és a beágyazott tartalmat.

Módszer	Leírás
`ParagraphConverter.get_paragraph_info()`	Formázási információk kinyerése egy bekezdésből
`ParagraphConverter.get_run_formatting()`	Formázási részletek lekérése egy szövegrészhez
`ParagraphConverter.format_text()`	Formázás alkalmazása a szövegtartalomra

Táblázat konverter

TableConverter átalakítja a dokumentumtáblákat a célformátumba (például Markdown táblák).

Módszer	Leírás
`TableConverter.convert()`	Táblázat elem konvertálása a kimeneti formátumba

Lista kezelő

ListHandler kezeli a lista állapotát a dokumentumkonverzió során, nyomon követve a lista beágyazását, jelölőket és a formázást.

Módszer	Leírás
`ListHandler.set_reader()`	A dokumentumolvasó beállítása a lista kontextusához
`ListHandler.reset()`	A lista nyomonkövetési állapotának visszaállítása
`ListHandler.get_list_info()`	Listaelem részleteinek lekérése egy bekezdéshez
`ListHandler.format_list_item()`	Listaelem formázása jelzővel és behúzással
`ListHandler.break_list()`	Jelzés a lista sorozat végére

Tippek és bevált gyakorlatok

A konvertereket belsőleg használja az exportcsővezeték — a legtöbb fejlesztő a Document.save()-vel dolgozik helyette
ParagraphConverter.format_text() tiszteletben tartja a kódrészlet kontextusát, hogy elkerülje az inline formázás alkalmazását a kódtartományokban
ListHandler állapotot tart fenn egymást követő lista bekezdések között — hívja a reset()-t új dokumentum szakasz kezdésekor

Gyakori problémák

Probléma	Ok	Javítás
Nem megfelelően igazított táblázatoszlopok	A bemeneti táblázat egyesített cellákat tartalmaz	`TableConverter` egyszerű táblázatokat kezel; az egyesített cellák váratlan kimenetet eredményezhetnek
Törött lista számozás	A lista állapota nem kerül visszaállításra a szakaszok között	Hívja meg a `ListHandler.reset()`‑t a szakaszhatárokon

API referencia összefoglaló

Osztály / Metódus	Leírás
`ParagraphConverter.get_paragraph_info()`	Bekezdés formázásának kinyerése
`ParagraphConverter.get_run_formatting()`	Run-szintű formázás lekérése
`ParagraphConverter.format_text()`	Formázás alkalmazása a szövegre
`TableConverter.convert()`	Táblázat konvertálása a kimeneti formátumba
`ListHandler.set_reader()`	Dokumentumolvasó kontextus beállítása
`ListHandler.get_list_info()`	Listaelem részleteinek lekérése
`ListHandler.format_list_item()`	Listaelem formázása