Tài liệu

Tổng quan

Document là điểm vào chính của Aspose.Words cho Python. Nó cung cấp API công cộng để tải các tài liệu Word (DOC, DOCX, RTF, TXT, Markdown), lưu vào nhiều định dạng đầu ra (PDF, DOCX, Markdown, TXT), và trích xuất văn bản thuần.

Được định nghĩa trong: aspose/words_foss/document.py

Hàm khởi tạo

Signature	Description
`Document(filepath=None, *, stream=None, data=None)`	Tải tài liệu từ đường dẫn tệp, luồng nhị phân hoặc byte thô. Ít nhất một nguồn phải được cung cấp.

Tham số:

Name	Type	Description
`filepath`	`Optional[Union[str, Path]]`	Đường dẫn tới tệp tài liệu cần tải.
`stream`	`Optional[BinaryIO]`	Luồng nhị phân chứa dữ liệu tài liệu.
`data`	`Optional[bytes]`	Byte thô của nội dung tài liệu.

Phương pháp

Chữ ký	Mô tả
`save(output_path, save_format_or_options=None)` → `None`	Lưu tài liệu sang định dạng được chỉ định. Định dạng có thể là một hằng chuỗi `SaveFormat` hoặc một đối tượng tùy chọn lưu (`PdfSaveOptions`, `MarkdownSaveOptions`).
`get_text()` → `str`	Trích xuất văn bản thuần từ tài liệu đã tải.

Thuộc tính

Tên	Kiểu	Quyền truy cập	Mô tả
`light_document_model`	`ldm.Document`	Đọc	Truy cập mô hình tài liệu ánh sáng nền để kiểm tra nâng cao cấu trúc tài liệu (đoạn văn, bảng, kiểu dáng, phần).

Sử dụng

import aspose.words_foss as aw

# Load a DOCX file
doc = aw.Document("input.docx")

# Extract plain text
text = doc.get_text()

# Save as PDF
doc.save("output.pdf", aw.SaveFormat.PDF)

# Save as Markdown
doc.save("output.md", aw.SaveFormat.MARKDOWN)

Mô hình tài liệu Light

Thuộc tính light_document_model cung cấp quyền truy cập vào cấu trúc tài liệu nội bộ (ldm.Document, được định nghĩa trong light_document_model.py). BaseModel pydantic này cho phép truy cập các đoạn văn đã phân tích, bảng, kiểu dáng, phần, tiêu đề, chân trang và các truy vấn cấu trúc như find_style() và headings(). Hầu hết người dùng không cần truy cập LDM trực tiếp — các phương thức công cộng Document ở trên đã bao phủ các quy trình làm việc tiêu chuẩn.