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

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

المجلس الوزاري Document class هو واجهة برمجة التطبيقات المركزية لتحميل مستندات Word وتحويلها إلى تنسيقيات أخرى. تغطي هذه الصفحة سير العمل في تحويل النماذج ، وإعداد خيارات الحفاظ ، واستخراج النص.


تحميل وتخزين

تحميل المستند مع Document() و اتصل به save() مع a SaveFormat ثابت لتحويل إلى تنسيق الناتج المستهدف. المدخلات الداعمة: DOCX، DO C، RTF، TXT، Markdown. الدخول المدعومة: PDF، 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، والامتثال لمعايير PDF، وإضافة الخطوط وغيرها من الإعدادات.

ملاحظة: (أوباما)PdfSaveOptions يتم تعريف خصائص (التوافق ، جودة JPEG ، وضع تضمين الخطوط ، ضغط الصورة ، إلخ) للتوافقة الأمامية مع API ولكن لم يستهلكها كاتب PDF بعد. لا يؤثر إعدادها حاليًا على الناتج.


تصدير التخفيض مع خيارات MarkdownSave

للخروج الافتراضي 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 يدعم التحكم في حفظ تنسيق التوضيح في الناتج.

ملاحظة: فقط export_underline_formatting يتم تطبيقه حالياً أثناء تصدير Markdown. غيرها MarkdownSaveOptions خصائص (table_content_alignment, list_export_mode, export_images_as_base64, images_folder, images_folder_alias) محددة للتوافق مع API ولكن لم يتم استهلاكها بعد من قبل كاتب Markdown.


استخراج النصوص

استخراج النص العادي من أي وثيقة محملة مع 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)

القضايا الشائعة

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

ملخص مرجع API

الفئة / الطريقةوصف
Documentتحميل مستندات Word من DOCX، DOK، RTF، TXT، أو Markdown
Document.save()حفظ إلى PDF، Markdown، أو النص العادي
Document.get_text()استخراج محتوى النص العادي
SaveFormatالثوابت: PDF, MARKDOWN, TEXT
PdfSaveOptionsتكوين تصدير PDF (الخصائص هي علامات التوافق المستقبلي؛ لم يتم تطبيقها بعد)
MarkdownSaveOptionsضبط تصدير تنسيق التوضيح
 العربية