Konverter

Interne API — Die Klassen auf dieser Seite werden intern von der Export‑Pipeline verwendet. Die meisten Entwickler interagieren stattdessen mit Document.save(). Siehe Core Management für die öffentliche API.

Aspose.Words FOSS for Python verwendet spezialisierte Konverterklassen, um das interne Dokumentenmodell in Ausgabeformate zu transformieren. ParagraphConverter verarbeitet Text und Formatierung, TableConverter verarbeitet Tabellenstrukturen und ListHandler verwaltet Listformatierung.

Absatzkonverter

ParagraphConverter wandelt Dokumentabsätze in das Zielausgabeformat um. Es prüft die Absatzformatierung, das Run-Level-Styling und den Inline-Inhalt.

Methode	Beschreibung
`ParagraphConverter.get_paragraph_info()`	Formatierungsinformationen aus einem Absatz extrahieren
`ParagraphConverter.get_run_formatting()`	Formatierungsdetails für einen Textlauf abrufen
`ParagraphConverter.format_text()`	Formatierung auf Textinhalt anwenden

Tabellenkonverter

TableConverter konvertiert Dokumenttabellen in das Zielformat (wie z. B. Markdown-Tabellen).

Methode	Beschreibung
`TableConverter.convert()`	Konvertiert ein Tabellenelement in das Ausgabeformat

Listen-Handler

ListHandler verwaltet den Listenstatus während der Dokumentkonvertierung, verfolgt die Listennestung, Marker und Formatierung.

Methode	Beschreibung
`ListHandler.set_reader()`	Setzt den Dokumentleser für den Listenkontext
`ListHandler.reset()`	Setzt den Listentracking-Status zurück
`ListHandler.get_list_info()`	Ruft Listenelementdetails für einen Absatz ab
`ListHandler.format_list_item()`	Formatiert ein Listenelement mit Marker und Einrückung
`ListHandler.break_list()`	Signalisiert das Ende einer Listensequenz

Tipps und bewährte Verfahren

Konverter werden intern von der Export‑Pipeline verwendet — die meisten Entwickler interagieren stattdessen mit Document.save()
ParagraphConverter.format_text() respektiert den Kontext von Codeblöcken, um die Anwendung von Inline‑Formatierungen innerhalb von Code‑Spans zu vermeiden
ListHandler behält den Zustand über aufeinanderfolgende List‑Absätze bei — rufen Sie reset() auf, wenn Sie einen neuen Dokumentabschnitt beginnen

Häufige Probleme

Problem	Ursache	Lösung
Falsch ausgerichtete Tabellenspalten	Eingabetabelle enthält zusammengeführte Zellen	`TableConverter` verarbeitet einfache Tabellen; zusammengeführte Zellen können unerwartete Ausgaben erzeugen
Fehlerhafte Listennummerierung	Listenstatus wird zwischen Abschnitten nicht zurückgesetzt	Rufen Sie `ListHandler.reset()` an Abschnittsgrenzen auf

API-Referenzübersicht

Klasse / Methode	Beschreibung
`ParagraphConverter.get_paragraph_info()`	Absatzformatierung extrahieren
`ParagraphConverter.get_run_formatting()`	Run‑Ebene‑Formatierung abrufen
`ParagraphConverter.format_text()`	Formatierung auf Text anwenden
`TableConverter.convert()`	Eine Tabelle in das Ausgabeformat konvertieren
`ListHandler.set_reader()`	Dokumentenleser‑Kontext festlegen
`ListHandler.get_list_info()`	Listenelementdetails abrufen
`ListHandler.format_list_item()`	Listenelement formatieren