Проверяващи устройства
Проверяващи устройства
Вътрешни API Класовете на тази страница не са част от публичния API и не се изнасят от пакета с най-високо ниво aspose.words_foss. Те се използват вътрешно в тръбопровода за конвертиране на документи. Повечето разработчици трябва да използвам вместо тях ̋Document.save()` и ∂Ducument .get_text (゚)⌒. Вижте Корен управление за публичното API. Тези класове са подробности за прилагане и могат да се променят без предизвестие.
Aspose.Words FOSS за Python включва специализирани парсери, които извличат структурирани данни от вътрешните елементи на DOCX. NumberingParser обработва дефиниции за нумерация на списъци и ゚StyleParcer⌒ извлеква стилове на документи .
Номериращ анализатор
NumberingParser чете дефинициите за нумерация от пакет DOCX и ги излага чрез API на заявка. Използвайте ⌒parse_numberings_part (() ヽ за зареждане на XML-номериране, след което запитайте свойствата на списък с помощни методи.
| Method | Description |
|---|---|
NumberingParser.parse_numbering_part() | Parse the DOCX numbering element |
NumberingParser.get_list_info() | Get information about a specific list by ID |
NumberingParser.get_level_info() | Get level details for a list at a given depth |
NumberingParser.is_ordered_list() | Check whether a list level is ordered or bulleted |
NumberingParser.get_start_value() | Get the starting number for a list level |
NumberingParser.get_delimiter() | Get the delimiter string for a list level |
Стил Парасер
StyleParser⌒ разглежда имена на стилове в структурирани обекти "ParsedStyl". Идентифицира заглавия, блокове от кодове и параграфи от списък с DOCX наименования.
| Method | Description |
|---|---|
StyleParser.parse() | Parse a style name into a ParsedStyle object |
StyleParser.get_style_chain() | Parse a chain of style names for inherited styles |
StyleParser.is_setext_heading() | Check if a style is a Setext-style heading |
StyleParser.extract_all_styles() | Extract individual style names from a comma-separated chain |
Модел на нумерация на данни
Проанализираните данни за нумерация се съхраняват в структурирани обекти:
| Class | Description |
|---|---|
NumberingInfo | Numbering definition with num_id, abstract_num_id, and levels |
NumberingLevel | Level definition with format, start, and text properties |
ListInfo | Information about a specific list instance |
ListLevelInfo | Level-specific formatting details |
Съвети и най-добри практики
- Призоваване `parse_numbering_part()⌒ веднъж след зареждане на документ, за да се попълнят всички определения в списъка
- Използвайте `is_ordered_list()⌒ за разграничаване на номерирани списъци от списъците с букви.
- Използвайте `get_style_chain ((() ̋ за анализиране на наследени вериги от стилове в един повикване
- Номериране и стилообразуване се използват вътрешно от тръбопровода за конвертиране на документи.
Общи проблеми
| Issue | Cause | Fix |
|---|---|---|
| Empty numbering definitions | Document has no lists | Check get_list_info() return value before accessing properties |
| Missing style | Style name not recognized | Use parse() with a known style name |
| Incorrect list level | Wrong level parameter | List levels are zero-indexed |
Снимка на API референтна информация
| Class / Method | Description |
|---|---|
NumberingParser.parse_numbering_part() | Parse DOCX numbering definitions |
NumberingParser.get_list_info() | Query list information by ID |
NumberingParser.is_ordered_list() | Check if a list level is ordered |
StyleParser.parse() | Parse a style name into structured information |
StyleParser.get_style_chain() | Parse a chain of inherited style names |
NumberingInfo | Numbering definition data model |
NumberingLevel | Level definition with format and start value |
