وثيقة

المعلومات العامة

Document هي نقطة الدخول الرئيسية لـ Aspose.Words FOSS لغة بايثون. إنها توفر واجهة برمجة التطبيقات العامة لشحن مستندات Word (DOC ، DOCX ، RTF ، TXT ، Markdown) ، والحفاظ على تنسيقين مخرجين متعددين (PDF ، markdown ، txt) واستخراج النص العادي.

تعريف: aspose/words_foss/document.py

البناة

التوقيع	وصف
`Document(filepath=None, *, stream=None, data=None)`	تحميل وثيقة من مسار ملف، التدفق الثنائي، أو البايتات الخام. يجب تقديم مصدر واحد على الأقل.

المعايير:

اسم	النوع	وصف
`filepath`	`Optional[Union[str, Path]]`	طريق إلى ملف المستند لتحميل.
`stream`	`Optional[BinaryIO]`	تيار ثنائي يحتوي على بيانات الوثيقة (بنسخة DOCX فقط).
`data`	`Optional[bytes]`	بايتات خام من محتوى الوثيقة (بنسخة DOCX فقط).

الطرق

التوقيع	وصف
`save(output_path, save_format_or_options=None)` → `None`	حفظ المستند إلى PDF (`SaveFormat.PDF`), التخفيض (`SaveFormat.MARKDOWN`) أو نص عادي (`SaveFormat.TEXT`) تمرير `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)

الصيغ المدعومة

صيغ الإدخال

شكل	`LoadFormat` ثابتة	وصف
DOCX	`LoadFormat.DOCX`	وثيقة Word المفتوحة من Office XML
DOC	`LoadFormat.DOC`	تنسيق ثنائي Microsoft Word القديم
RTF	`LoadFormat.RTF`	شكل النص الغني
TXT	`LoadFormat.TEXT`	نص بسيط
التخفيضات	`LoadFormat.MARKDOWN`	CommonMark التخفيضات
سيارات	`LoadFormat.AUTO`	الكشف عن الصيغة من امتداد الملف (الجهل)

صيغ المخرجات

شكل	`SaveFormat` ثابتة	حفظ الخيارات
PDF	`SaveFormat.PDF`	`PdfSaveOptions` تهيئة الامتثال، ضغط الصورة، إدراج الخطوط
التخفيضات	`SaveFormat.MARKDOWN`	`MarkdownSaveOptions` تهيئة ترتيب الجدول، تصدير الصورة، وضع القائمة
نص بسيط	`SaveFormat.TEXT`	—
DOCX	`SaveFormat.DOCX`	ثابت القراءة فقط. `Document.save()` لا يدعم DOCX يرفع `ValueError`.
DOC	`SaveFormat.DOC`	ثابت القراءة فقط. `Document.save()` لا تدعم DOC الزيادات `ValueError`.

نموذج وثيقة ضوئيّة

المجلس الوزاري light_document_model يمنح الموقع الوصول إلى هيكل الوثيقة الداخلية (ldm.Document,، محددة في light_document_model.py) هذا البيدني BaseModel يعرض الفقرات المفصلة، الجداول، الأساليب، القسمات، الرؤوس، أسفل الأسئلة والإستفسارات الهيكلية مثل find_style() و headings().معظم المستخدمين لا يحتاجون إلى الوصول مباشرةً إلى نظام LDM الجمهور Document تتضمن الطرق المذكورة أعلاه سير العمل القياسي.

انظر أيضاً

SaveFormat ثابتات شكل الخروج المستخدمة مع Document.save()
LoadFormat ثابتات شكل الإدخال لمواصفات الشكل الصريحة
PdfSaveOptions مراقبة تصدير PDF دقيقة الحجم (مستوى الامتثال، الضغط، إدراج الخطوط)
MarkdownSaveOptions خيارات التصدير (التوافق مع الجدول، التعامل مع الصور، وضع القائمة)