Jak konwertować dokumenty przy użyciu klas konwertera w Pythonie

Jak konwertować dokumenty przy użyciu klas konwertera

Aspose.Words FOSS for Python używa wewnętrznych klas konwertera podczas eksportu dokumentu. Chociaż większość użytkowników korzysta z Document.save(), zrozumienie klas konwertera jest przydatne w zaawansowanych scenariuszach.

Wymagania wstępne

Zainstaluj bibliotekę:

pip install aspose-words-foss>=26.4.0

Wymaga Pythona 3.10 lub nowszego.

ParagraphConverter

ParagraphConverter przekształca akapity dokumentu w docelowy format wyjściowy. Kluczowe metody:

• ParagraphConverter.get_paragraph_info() — wyodrębnić informacje o formatowaniu z akapitu
• ParagraphConverter.get_run_formatting() — pobrać formatowanie dla fragmentu tekstu
• ParagraphConverter.format_text() — zastosować formatowanie do treści tekstowej

TableConverter

TableConverter konwertuje tabele dokumentu do formatu docelowego (takiego jak tabele Markdown):

• TableConverter.convert() — konwertować element tabeli do formatu wyjściowego

ListHandler

ListHandler zarządza stanem listy podczas konwersji:

• ListHandler.set_reader() — ustaw kontekst czytnika dokumentu
• ListHandler.reset() — zresetuj stan śledzenia listy
• ListHandler.get_list_info() — pobierz szczegóły elementu listy dla akapitu
• ListHandler.format_list_item() — sformatuj element listy z markerem i wcięciem
• ListHandler.break_list() — sygnalizuj koniec sekwencji listy

Szybki przykład konwersji

W większości przypadków użyj Document.save() bezpośrednio — klasy konwertera są wywoływane automatycznie:

import aspose.words_foss as aw

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

Podsumowanie