سند
بررسی کلی
Document نقطه ورودی اصلی Aspose.Words برای Python است. این API عمومی برای بارگذاری اسناد Word (DOC, DOCX, RTF, TXT, Markdown)، ذخیرهسازی به چندین فرمت خروجی (PDF, DOCX, Markdown, TXT) و استخراج متن ساده را فراهم میکند.
تعریف شده در: aspose/words_foss/document.py
سازنده
| امضا | توضیح |
|---|---|
Document(filepath=None, *, stream=None, data=None) | یک سند را از مسیر فایل، جریان باینری یا بایتهای خام بارگذاری میکند. حداقل یک منبع باید ارائه شود. |
پارامترها:
| نام | نوع | توضیح |
|---|---|---|
filepath | Optional[Union[str, Path]] | مسیر فایل سند برای بارگذاری. |
stream | Optional[BinaryIO] | جریان باینری حاوی دادههای سند. |
data | Optional[bytes] | بایتهای خام محتوای سند. |
روشها
| Signature | Description |
|---|---|
save(output_path, save_format_or_options=None) → None | سند را در قالب مشخص شده ذخیره کنید. قالب میتواند یک ثابت رشتهای SaveFormat یا یک شیء گزینههای ذخیرهسازی (PdfSaveOptions، MarkdownSaveOptions) باشد. |
get_text() → str | متن ساده را از سند بارگذاریشده استخراج کنید. |
ویژگیها
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
light_document_model | ldm.Document | خواندن | دسترسی به مدل سبک سند زیرین برای بازرسی پیشرفته ساختار سند (پاراگرافها، جدولها، سبکها، بخشها). |
استفاده
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 پایدنیک پاراگرافهای تجزیهشده، جداول، سبکها، بخشها، سرصفحهها، پاورقیها و پرسوجوهای ساختاری مانند find_style() و headings() را نمایش میدهد. اکثر کاربران نیازی به دسترسی مستقیم به LDM ندارند — روشهای عمومی Document که در بالا آمدهاند، جریانهای کاری استاندارد را پوشش میدهند.
