เอกสาร

ภาพรวม

Document คือจุดเริ่มต้นหลักของ Aspose.Words for Python มันให้ public API สำหรับโหลดเอกสาร Word (DOC, DOCX, RTF, TXT, Markdown) บันทึกเป็นหลายรูปแบบผลลัพธ์ (PDF, DOCX, Markdown, TXT) และสกัดข้อความธรรมดา.

กำหนดใน: aspose/words_foss/document.py

คอนสตรัคเตอร์

ลายเซ็น	คำอธิบาย
`Document(filepath=None, *, stream=None, data=None)`	โหลดเอกสารจากเส้นทางไฟล์, สตรีมไบนารี หรือไบต์ดิบ อย่างน้อยต้องระบุแหล่งข้อมูลอย่างหนึ่ง

พารามิเตอร์:

Name	Type	Description
`filepath`	`Optional[Union[str, Path]]`	เส้นทางไปยังไฟล์เอกสารที่ต้องการโหลด
`stream`	`Optional[BinaryIO]`	สตรีมไบนารีที่มีข้อมูลเอกสาร
`data`	`Optional[bytes]`	ไบต์ดิบของเนื้อหาเอกสาร

วิธีการ

ลายเซ็น	คำอธิบาย
`save(output_path, save_format_or_options=None)` → `None`	บันทึกเอกสารเป็นรูปแบบที่ระบุ รูปแบบอาจเป็นค่าคงที่สตริง `SaveFormat` หรืออ็อบเจ็กต์ตัวเลือกการบันทึก (`PdfSaveOptions`, `MarkdownSaveOptions`)
`get_text()` → `str`	สกัดข้อความธรรมดาจากเอกสารที่โหลด

คุณสมบัติ

Name	Type	Access	Description
`light_document_model`	`ldm.Document`	อ่าน	เข้าถึง light document model เพื่อการตรวจสอบขั้นสูงของโครงสร้างเอกสาร (paragraphs, tables, styles, sections).

การใช้งาน

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)

โมเดลเอกสาร Light

คุณสมบัติ light_document_model ให้การเข้าถึงโครงสร้างเอกสารภายใน (ldm.Document, กำหนดใน light_document_model.py) ตัว BaseModel ของ pydantic นี้เปิดเผยย่อหน้าที่แยกวิเคราะห์ ตาราง สไตล์ ส่วนหัว ส่วนท้าย และการสอบถามเชิงโครงสร้างเช่น find_style() และ headings() ผู้ใช้ส่วนใหญ่ไม่จำเป็นต้องเข้าถึง LDM โดยตรง — วิธีการสาธารณะ Document ด้านบนครอบคลุมกระบวนการทำงานมาตรฐาน.