إدارة النواة
الإدارة الأساسية
الفئة Document هي واجهة برمجة التطبيقات المركزية لتحميل مستندات Word وتحويلها إلى صيغ أخرى. تغطي هذه الصفحة سير عمل تحويل الصيغ، وتكوين خيارات الحفظ، واستخراج النص.
التحميل والحفظ
حمّل مستندًا باستخدام Document() واستدعِ save() مع ثابت SaveFormat لتحويل بين الصيغ. المدخلات المدعومة: DOCX، DOC، RTF، TXT، Markdown. المخرجات المدعومة: PDF، DOCX، DOC، Markdown، TXT.
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.md", aw.SaveFormat.MARKDOWN)
doc.save("output.pdf", aw.SaveFormat.PDF)
doc.save("output.txt", aw.SaveFormat.TEXT)استدعِ save() عدة مرات على نفس Document لإنتاج صيغ إخراج متعددة دون إعادة التحميل.
تصدير PDF باستخدام PdfSaveOptions
لإخراج PDF الافتراضي، مرّر SaveFormat.PDF. للتحكم الدقيق، استخدم كائن PdfSaveOptions:
import aspose.words_foss as aw
from aspose.words_foss.saving import PdfSaveOptions
doc = aw.Document("input.docx")
# Default PDF export
doc.save("default.pdf", aw.SaveFormat.PDF)
# Customized PDF export with save options
doc.save("custom.pdf", PdfSaveOptions())PdfSaveOptions يقبل إعدادات جودة صورة JPEG (0–100، الافتراضي 100) ومستوى الامتثال لمعايير PDF (الافتراضي PDF/1.7).
تصدير Markdown باستخدام MarkdownSaveOptions
للحصول على إخراج Markdown افتراضي، مرّر SaveFormat.MARKDOWN. استخدم MarkdownSaveOptions عندما تحتاج إلى التحكم في سلوك التنسيق:
import aspose.words_foss as aw
from aspose.words_foss.saving import MarkdownSaveOptions
doc = aw.Document("input.docx")
# Default Markdown export
doc.save("default.md", aw.SaveFormat.MARKDOWN)
# Customized Markdown export with save options
doc.save("with_options.md", MarkdownSaveOptions())MarkdownSaveOptions يدعم التحكم في الحفاظ على تنسيق الخط السفلي في الإخراج.
استخراج النص
استخراج النص العادي من أي مستند تم تحميله باستخدام get_text():
import aspose.words_foss as aw
doc = aw.Document("input.docx")
text = doc.get_text()لإخراج ملف نصي، استخدم SaveFormat.TEXT:
doc.save("output.txt", aw.SaveFormat.TEXT)مشكلات شائعة
| Issue | Cause | Fix |
|---|---|---|
ModuleNotFoundError | الحزمة غير مثبتة | تشغيل pip install aspose-words-foss>=26.4.0 |
نص فارغ من get_text() | ملف الإدخال فارغ أو معطوب | تحقق من أن ملف الإدخال يفتح بشكل صحيح في معالج النصوص |
| إخراج PDF يفتقد الصور | تنسيق الصورة غير مدعوم من قبل المحول | استخدم ملف DOCX كإدخال مع صور مدمجة قياسية |
ملخص مرجع API
| Class / Method | Description |
|---|---|
Document | تحميل مستندات Word من DOCX أو DOC أو RTF أو TXT أو Markdown |
Document.save() | حفظ إلى PDF أو Markdown أو DOCX أو DOC أو نص عادي |
Document.get_text() | استخراج محتوى النص العادي |
SaveFormat | الثوابت: PDF، MARKDOWN، TEXT، DOC، DOCX |
PdfSaveOptions | تكوين توافق PDF وجودة JPEG |
MarkdownSaveOptions | تكوين تصدير تنسيق التسطير |