Jak převádět dokumenty pomocí tříd Converter v Pythonu

Jak převádět dokumenty pomocí tříd konvertoru

Aspose.Words FOSS for Python používá interní třídy konvertoru během exportu dokumentu. Zatímco většina uživatelů pracuje s Document.save(), pochopení tříd konvertoru je užitečné pro pokročilé scénáře.

Požadavky

Nainstalujte knihovnu:

pip install aspose-words-foss>=26.4.0

Vyžaduje Python 3.10 nebo novější.

ParagraphConverter

ParagraphConverter převádí odstavce dokumentu do cílového výstupního formátu. Klíčové metody:

• ParagraphConverter.get_paragraph_info() — extrahovat informace o formátování z odstavce
• ParagraphConverter.get_run_formatting() — získat formátování pro textový úsek
• ParagraphConverter.format_text() — aplikovat formátování na textový obsah

TableConverter

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

• TableConverter.convert() — převést prvek tabulky do výstupního formátu

ListHandler

ListHandler spravuje stav seznamu během konverze:

• ListHandler.set_reader() — nastavit kontext čtečky dokumentu
• 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

Rychlý příklad konverze

Pro většinu případů použití použijte Document.save() přímo — konvertorové třídy jsou vyvolány automaticky:

import aspose.words_foss as aw

doc = aw.Document("input.docx")
doc.save("output.pdf", aw.SaveFormat.PDF)

Shrnutí