מסמך – Aspose FOSS API Reference

מסמך

סקירה כללית

Document הוא נקודת הכניסה הראשית של Aspose.Words for 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]`	בתים גולמיים של תוכן המסמך.

שיטות

חתימה	תיאור
`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_document_model מספק גישה למבנה הפנימי של המסמך (ldm.Document, המוגדר בlight_document_model.py). הBaseModel של pydantic חושף פסקאות, טבלאות, סגנונות, מקטעים, כותרות, כותרות תחתונות ושאילתות מבניות כגון find_style() וheadings(). רוב המשתמשים אינם צריכים לגשת ל‑LDM ישירות — השיטות הציבוריות Document למעלה מכסות זרימות עבודה סטנדרטיות.