Parsers

API interna Les classes d’aquesta pàgina no formen part de l’API pública i no s’exporten des del nivell superior. aspose.words_foss Els programadors han d’utilitzar el paquet de conversió. Document.save() i de la Document.get_text() En lloc d’això. Gestió de base Aquestes classes són detalls d’implementació i poden canviar sense previ avís.

Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser gestiona les definicions de numeració d’unes llistes, i StyleParser extraeix els estils de document.

Parser de numeració

NumberingParser Llegeix les definicions de numeració d’un paquet DOCX i els exposa a través d ‘una API de consulta. Utilitzar parse_numbering_part() per carregar la numeració XML, després fer preguntes a les propietats de listes amb mètodes auxiliars.

Mètode	Descripció
`NumberingParser.parse_numbering_part()`	Anàlisi de l’element de numeració DOCX
`NumberingParser.get_list_info()`	Obtindre informació sobre una llista específica per ID
`NumberingParser.get_level_info()`	Obtindre detalls de nivell per a una llista en una profunditat determinada
`NumberingParser.is_ordered_list()`	Comprovar si un nivell de llista està ordenat o amb puntes.
`NumberingParser.get_start_value()`	Obtindre el número inicial per a un nivell de llista
`NumberingParser.get_delimiter()`	Obtindre la cadena delimitadora per a un nivell d’una llista

Parser d’estil

StyleParser Parseja noms de estil en estructurats ParsedStyle Identifica títols, blockquotes, blocs de codi i paràgrafs d’una llista a partir dels noms de estil DOCX.

Mètode	Descripció
`StyleParser.parse()`	Anàlisi d’un nom de estil en un `ParsedStyle` objecte
`StyleParser.get_style_chain()`	Anàlisi d’una cadena de noms d ’estil per a estils heretats
`StyleParser.is_setext_heading()`	Comprovar si un estil és un títol de tipus Setext.
`StyleParser.extract_all_styles()`	Extreure noms de estil individuals d’una cadena separada per comas.

Modell de dades de numeració

Les dades de numeració analitzades s’emmagatzemen en objectes estructurats:

Classe	Descripció
`NumberingInfo`	Definició de numeració amb: `num_id`, `abstract_num_id`, i `levels`
`NumberingLevel`	Definició de nivell amb: `format`, `start`, i `text` propietats
`ListInfo`	Informació sobre una instància de llista específica
`ListLevelInfo`	Detalls de formatació específics per nivell

Consells i millors pràctiques

L’anomenaràs. parse_numbering_part() una vegada després de carregar un document per omplir totes les definicions d’una llista.
Utilització: is_ordered_list() per distingir les llistes numerades de les listes amb indicadors.
Utilització: get_style_chain() per analitzar cadenes d’estil heretades en una sola crida
Els parseadors de numeració i estil s’utilitzen internament per la línia de conversió del document.

Problemàtiques comuns

Edició	Causa	Correcció
Definicions de numeració buides	Document no té llistes	Compte de pagament `get_list_info()` valor de retorn abans d’accedir a propietats.
Estic absent	Nom de estil no reconegut	Utilització: `parse()` amb un nom de estil conegut.
Nivel de llista incorrecte	Paramètre de nivell incorrecte	Els nivells de llista són indexats a zero.

Resum de referència d’API

Classe / mètode	Descripció
`NumberingParser.parse_numbering_part()`	Parse Docx definicions de numeració
`NumberingParser.get_list_info()`	Informació de la llista d’interrogades per ID
`NumberingParser.is_ordered_list()`	Comprovar si es va ordenar un nivell de llista
`StyleParser.parse()`	Anàlisi d’un nom de estil en informació estructurada
`StyleParser.get_style_chain()`	Anàlisi d’una cadena de noms d ’estil heretats
`NumberingInfo`	Modell de dades de definició de numeració
`NumberingLevel`	Definició de nivell amb format i valor inicial