Dokumen

Gambaran Keseluruhan

Document ialah titik masuk utama Aspose.Words untuk Python. Ia menyediakan API awam untuk memuatkan dokumen Word (DOC, DOCX, RTF, TXT, Markdown), menyimpan ke pelbagai format output (PDF, DOCX, Markdown, TXT), dan mengekstrak teks biasa.

Ditakrifkan dalam: aspose/words_foss/document.py

Pembina

Signature	Description
`Document(filepath=None, *, stream=None, data=None)`	Muatkan dokumen dari laluan fail, aliran binari, atau bait mentah. Sekurang‑kurangnya satu sumber mesti disediakan.

Parameter:

Name	Type	Description
`filepath`	`Optional[Union[str, Path]]`	Laluan ke fail dokumen untuk dimuatkan.
`stream`	`Optional[BinaryIO]`	Aliran binari yang mengandungi data dokumen.
`data`	`Optional[bytes]`	Bait mentah kandungan dokumen.

Kaedah

Signature	Description
`save(output_path, save_format_or_options=None)` → `None`	Simpan dokumen ke format yang ditentukan. Format tersebut boleh menjadi konstanta rentetan `SaveFormat` atau objek pilihan‑simpan (`PdfSaveOptions`, `MarkdownSaveOptions`).
`get_text()` → `str`	Ekstrak teks biasa dari dokumen yang dimuatkan.

Ciri-ciri

Nama	Jenis	Akses	Keterangan
`light_document_model`	`ldm.Document`	Baca	Akses model dokumen ringan yang mendasari untuk pemeriksaan lanjutan struktur dokumen (perenggan, jadual, gaya, bahagian).

Penggunaan

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)

Model Dokumen Ringan

Properti light_document_model menyediakan akses kepada struktur dokumen dalaman (ldm.Document, yang ditakrifkan dalam light_document_model.py). Pydantic BaseModel ini mendedahkan perenggan, jadual, gaya, bahagian, pengepala, pengaki, dan pertanyaan struktur seperti find_style() dan headings(). Kebanyakan pengguna tidak perlu mengakses LDM secara langsung — kaedah awam Document di atas meliputi aliran kerja standard.