Parsers
Parsers
Внутрішній API Класи на цій сторінці не є частиною публічного API і не експортуються з верхнього рівня.
aspose.words_fossВони використовуються внутрішньо в документоконверсії. Більшість розробників повинні використовувати їх для конвертації файлів.Document.save()іDocument.get_text()Замість цього. Основне управління Ці класи є деталями реалізації і можуть змінюватися без попереднього повідомлення.
Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser обробляє визначення перелікових нумерацій, а також StyleParser витягує стилі документів.
Номерувальний аналізатор
NumberingParser читає визначення нумерації з пакету DOCX і висвітлює їх через API запитів. Використовуйте parse_numbering_part() завантажити нумерацію XML, а потім запитувати властивості списку з допомогою методів-помочніків.
| Method | Description |
|---|---|
NumberingParser.parse_numbering_part() | Розгляньте елемент нумерації DOCX |
NumberingParser.get_list_info() | Отримати інформацію про конкретний список за ідентифікатором |
NumberingParser.get_level_info() | Отримати деталі рівня для списку на даній глибині |
NumberingParser.is_ordered_list() | Перевірка, чи є рівень списку упорядкованим або означений клейками. |
NumberingParser.get_start_value() | Отримати початковий номер для рівня списку |
NumberingParser.get_delimiter() | Отримати ряд делімітера для рівня списку . |
Стільний аналізатор
StyleParser переглядати імена стилів у структуровані ParsedStyle Це ідентифікує заголовки, блокові котировки і перелічні абзаці з DOCX-назв стилю.
| Method | Description |
|---|---|
StyleParser.parse() | Переглянути назву стилю в ParsedStyle об’єкт |
StyleParser.get_style_chain() | Переглянути ланцюжок назв стилів для успадкованих стилей |
StyleParser.is_setext_heading() | Перевірка, чи є стиль заголовком в стилі Setext |
StyleParser.extract_all_styles() | Витягнення окремих імен стилів з ланцюга, розділеного затишками. |
Модель даних про нумерацію
Переглянути дані про нумерацію зберігаються в структурованих об’єктах:
| Class | Description |
|---|---|
NumberingInfo | Означення нумерації з: num_id, abstract_num_id, і levels |
NumberingLevel | Визначення рівня з: format, start, і text властивості |
ListInfo | Інформація про конкретну інстанцію списку |
ListLevelInfo | Детальні дані про форматизацію відповідно до рівня |
Поради та найкращі практики
- Call
parse_numbering_part()один раз після завантаження документа для заповнення всіх визначенняв списку - Використання
is_ordered_list()розрізняти нумераційні списки від переліків з значками. - Використання
get_style_chain()для аналізу успадкованих ланцюгів стилів за одним дзвінком - Номерування та стилізація парсерів використовуються внутрішньо в трубопроводі конвертації документів.
Загальні питання
| Issue | Cause | Виправлення |
|---|---|---|
| Пусті визначення нумерації | Документ не має списків | Check get_list_info() return value перед доступом до властивостей |
| Недостатній стиль | Назва стилю не визнана | Використання parse() з відомим ім’ям стилю |
| Неправильний рівень списку | Неправильний параметр рівня | Рівни списку є нульовими. |
Реферат на API
| Клас / метод | Description |
|---|---|
NumberingParser.parse_numbering_part() | Parse DOCX нумерації визначення |
NumberingParser.get_list_info() | Інформація про список запитів за ідентифікатором |
NumberingParser.is_ordered_list() | Перевірка, чи замовлений рівень списку. |
StyleParser.parse() | Розглянути назву стилю в структуровану інформацію |
StyleParser.get_style_chain() | Аналізуйте ланцюжок успадкованих імен стилів |
NumberingInfo | Модель даних визначення нумерації |
NumberingLevel | Визначення рівня з форматизацією та початковим значенням |
