Parser
Parser
Interne API Die Klassen auf dieser Seite sind nicht Teil der öffentlichen API und werden nicht von der obersten Ebene exportiert.
aspose.words_fossDie meisten Entwickler sollten die Software verwenden, um das Dokument zu konvertieren.Document.save()und .Document.get_text()Siehe hier. Kernmanagement Diese Klassen sind Implementierungsdetails und können ohne vorherige Ankündigung geändert werden.
Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser die Definitionen der Liste für die Nummerierung behandelt und StyleParser Extraktion von Dokumenten.
Nummerierbarkeit des Parser-Systems
NumberingParser Lesen Sie die Nummerierungsdefinitionen aus einem DOCX-Paket und stellen sie über eine Abfrage API zur Verfügung. Verwenden parse_numbering_part() Um die Nummerierung von XML zu laden, werden dann Liste-Eigenschaften mit Hilfsmethoden abgerufen.
| Verfahren | Beschreibung |
|---|---|
NumberingParser.parse_numbering_part() | Das DOCX-Nummernelement analysieren |
NumberingParser.get_list_info() | Informationen über eine bestimmte Liste nach ID erhalten |
NumberingParser.get_level_info() | Erhalten Sie die Details für eine Liste in einer bestimmten Tiefe. |
NumberingParser.is_ordered_list() | Überprüfen, ob eine Liste in Reihenfolge oder mit Schaltzeichen ausgewiesen ist. |
NumberingParser.get_start_value() | Erhalten Sie die Startnummer für eine Liste Ebene |
NumberingParser.get_delimiter() | Erhalten Sie die Abgrenzungszeile für eine Liste Ebene |
Stil-Parser
StyleParser Parse von Stilnamen in strukturierte Form ParsedStyle Objekt. Es identifiziert Überschriften, Blockquoten, Codeblöcke und Listenunterstaffungen aus DOCX-Stilnamen.
| Verfahren | Beschreibung |
|---|---|
StyleParser.parse() | Ein Stilnamen in eine Form analysieren. ParsedStyle Gegenstand |
StyleParser.get_style_chain() | Analyse einer Kette von Stilnamen für vererbte Stile |
StyleParser.is_setext_heading() | Überprüfen Sie, ob ein Stil eine Setext-Stilüberschrift ist. |
StyleParser.extract_all_styles() | Einzelne Stilnamen aus einer durch Komma getrennten Kette extrahieren |
Nummernmodell für Daten
Die durchgeordneten Nummerierungsdaten werden in strukturierten Objekten gespeichert:
| Klasse | Beschreibung |
|---|---|
NumberingInfo | Definition der Nummerierung mit: num_id, abstract_num_id,und . levels |
NumberingLevel | Ebene mit format, start,und . text Eigenschaften |
ListInfo | Informationen über eine bestimmte Listeinstance |
ListLevelInfo | Ebene-spezifische Formatierungsdetails |
Tipps und beste Praktiken
- Rufen Sie an .
parse_numbering_part()Einmal nach dem Laden eines Dokuments, um alle Liste-Definitionen zu füllen. - Verwendung
is_ordered_list()die Nummernlisten von den Schaltzellenlistan unterscheiden; - Verwendung
get_style_chain()die vererbte Stilkette in einem einzigen Aufruf zu analysieren - Nummerierungs- und Stilparser werden intern von der Dokumentenkonvertierungspipeline verwendet.
Häufige Probleme
| Ausgabe | Ursache | Behebung |
|---|---|---|
| Leere Definitionen der Nummerierung | Dokument hat keine Listen | Überprüfung get_list_info() Rückgabewert vor dem Zugang zu Eigenschaften |
| Fehlende Form | Stilbezeichnung nicht erkannt | Verwendung parse() mit einem bekannten Stilnamen |
| Falsche Listeebene | Falscher Niveauparameter | Liste-Ebenen sind Nullindex. |
Zusammenfassung der API-Referenzen
| Klasse / Methode | Beschreibung |
|---|---|
NumberingParser.parse_numbering_part() | Parse DOCX-Nummern definiert |
NumberingParser.get_list_info() | Informationen über die Abfrageliste nach ID |
NumberingParser.is_ordered_list() | Überprüfen, ob eine Liste angeordnet ist. |
StyleParser.parse() | Ein Stilnamen in strukturierte Informationen analysieren |
StyleParser.get_style_chain() | Analyse einer Kette von ererbten Stilnamen |
NumberingInfo | Modell für die Definition der Nummern |
NumberingLevel | Ebene-Definition mit Format und Startwert |