الإدارة الأساسية
الإدارة الأساسية
المجلس الوزاري 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 | ضبط تصدير تنسيق التوضيح |