إدارة النواة

إدارة النواة

الإدارة الأساسية

الفئة 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)

مشكلات شائعة

IssueCauseFix
ModuleNotFoundErrorالحزمة غير مثبتةتشغيل pip install aspose-words-foss>=26.4.0
نص فارغ من get_text()ملف الإدخال فارغ أو معطوبتحقق من أن ملف الإدخال يفتح بشكل صحيح في معالج النصوص
إخراج PDF يفتقد الصورتنسيق الصورة غير مدعوم من قبل المحولاستخدم ملف DOCX كإدخال مع صور مدمجة قياسية

ملخص مرجع API

Class / MethodDescription
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تكوين تصدير تنسيق التسطير
 العربية