Parsers
Parsers
Lửa nội bộ Các lớp học trên trang này không phải là một phần của API công cộng và không được xuất khẩu từ cấp cao.
aspose.words_fossgói. chúng được sử dụng bên trong bởi đường ống chuyển đổi tài liệu. hầu hết các nhà phát triển nên sửDocument.save()vàDocument.get_text()Thay vào đó, xem Quản lý Core Đối với API công cộng. Các lớp này là chi tiết thực hiện và có thể thay đổi mà không cần thông báo.
Aspose.Words FOSS for Python includes specialized parsers that extract structured data from DOCX internals. The NumberingParser - Tính toán danh sách số định nghĩa, và StyleParser - Tạo các kiểu tài liệu.
Số Parser
NumberingParser đọc các định nghĩa số từ một gói DOCX và tiết lộ chúng thông qua API truy vấn. parse_numbering_part() để tải số XML, sau đó truy vấn danh sách thuộc tính với phương pháp trợ giúp.
| Method | Description |
|---|---|
NumberingParser.parse_numbering_part() | - Tải về DOCX Numbering Element |
NumberingParser.get_list_info() | Nhận thông tin về một danh sách cụ thể bằng ID |
NumberingParser.get_level_info() | Nhận chi tiết cấp cho một danh sách ở độ sâu nhất định |
NumberingParser.is_ordered_list() | Kiểm tra xem một mức danh sách được đặt hàng hoặc bị đánh đập |
NumberingParser.get_start_value() | Nhận số khởi động cho một cấp danh sách |
NumberingParser.get_delimiter() | Nhận dòng delimiter cho một cấp danh sách |
Phong cách Parser
StyleParser Parse style tên thành cấu trúc ParsedStyle Nó xác định tiêu đề, blockquotes, mã khối và các đoạn danh sách từ tên phong cách DOCX.
| Method | Description |
|---|---|
StyleParser.parse() | Chia tên phong cách thành a ParsedStyle đối tượng |
StyleParser.get_style_chain() | Chia sẻ một chuỗi tên phong cách cho các phong tục di sản |
StyleParser.is_setext_heading() | Kiểm tra xem một phong cách là một tiêu đề kiểu Setext |
StyleParser.extract_all_styles() | Thu thập tên phong cách cá nhân từ một chuỗi tách biệt comma |
Số mô hình dữ liệu
Dữ liệu số Parsed được lưu trữ trong các đối tượng cấu trúc:
| Class | Description |
|---|---|
NumberingInfo | Định nghĩa số với num_id, abstract_num_id, và levels |
NumberingLevel | Định nghĩa cấp độ với format, start, và text Tài sản |
ListInfo | Thông tin về một danh sách cụ thể |
ListLevelInfo | - Thông tin định dạng cấp độ cụ thể |
Mẹo và Thực hành Tốt nhất
- Call
parse_numbering_part()một lần sau khi tải lên tài liệu để lưu trữ tất cả các định nghĩa danh sách - Sử dụng
is_ordered_list()Để phân biệt danh sách số từ danh mục được đánh bóng - Sử dụng
get_style_chain()để chia sẻ chuỗi phong cách di sản trong một cuộc gọi duy nhất - Số và phong cách của các bộ đệm được sử dụng bên trong bởi đường ống chuyển đổi tài liệu
Các vấn đề thường gặp
| Issue | Cause | Fix Đặt |
|---|---|---|
| Định nghĩa số trống | Tài liệu không có danh sách | Check get_list_info() Giá trị trả lại trước khi truy cập tài sản |
| Lạc phong cách | Tên phong cách không được công nhận | Sử dụng parse() Với một tên phong cách quen thuộc |
| Lớp danh sách sai lệch | Mức độ sai parameters | Các mức danh sách là zero-indexed |
Tóm tắt Tham chiếu API
| Class / Phương pháp | Description |
|---|---|
NumberingParser.parse_numbering_part() | Parse DOCX định nghĩa số hóa |
NumberingParser.get_list_info() | Danh sách truy vấn thông tin bằng ID |
NumberingParser.is_ordered_list() | Kiểm tra xem một mức danh sách được đặt hàng |
StyleParser.parse() | Chia tên phong cách vào thông tin cấu trúc |
StyleParser.get_style_chain() | Parse một chuỗi tên phong cách di sản |
NumberingInfo | Định nghĩa số mô hình dữ liệu |
NumberingLevel | Định nghĩa cấp độ với định dạng và giá trị khởi đầu |
