مقدمة
توفر Aspose.Words FOSS للبايثون واجهة برمجة تطبيقات بسيطة لتحويل مستندات Word بين الصيغ. تقوم الفئة Document بتحميل الملفات بخمس صيغ إدخال وتقوم الطريقة save() بتصديرها إلى PDF أو Markdown أو نص عادي.
تستعرض هذه المقالة سير عمل التحويل الأساسية، من التحويل الفردي للملف إلى المعالجة الدفعية عبر جميع الصيغ المدعومة.
الميزات الرئيسية
تحويل مستند واحد
حمّل أي ملف مدعوم كمدخل وحوّله إلى تنسيق هدف باستخدام سطرين من الشيفرة. يقبل مُنشئ Document ملفات DOCX و DOC و RTF و TXT و Markdown.
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf", aw.SaveFormat.PDF)
تحويل دفعي إلى صيغ متعددة
استدعِ save() عدة مرات على نفس المستند المحمَّل لإنتاج مخرجات بكل تنسيق مدعوم دون إعادة تحميل ملف الإدخال.
import aspose.words_foss as aw
doc = aw.Document("report.docx")
doc.save("report.md", aw.SaveFormat.MARKDOWN)
doc.save("report.pdf", aw.SaveFormat.PDF)
doc.save("report.txt", aw.SaveFormat.TEXT)
تصدير PDF باستخدام PdfSaveOptions
استخدم PdfSaveOptions للتحكم الدقيق في إخراج PDF. بالنسبة للإعدادات الافتراضية، SaveFormat.PDF كافية.
import aspose.words_foss as aw
from aspose.words_foss.saving import PdfSaveOptions
doc = aw.Document("input.docx")
pdf_opts = PdfSaveOptions()
doc.save("output.pdf", pdf_opts)
تصدير Markdown باستخدام MarkdownSaveOptions
استخدم MarkdownSaveOptions للحصول على تحكم إضافي في تنسيق إخراج Markdown.
import aspose.words_foss as aw
from aspose.words_foss.saving import MarkdownSaveOptions
doc = aw.Document("input.docx")
md_opts = MarkdownSaveOptions()
doc.save("output.md", md_opts)
استخراج النص
استخراج محتوى النص العادي من أي مستند تم تحميله باستخدام Document.get_text() دون كتابة إلى ملف.
import aspose.words_foss as aw
doc = aw.Document("input.docx")
text = doc.get_text()
print(f"Extracted {len(text)} characters")
البدء السريع
pip install aspose-words-foss>=26.4.0
import aspose.words_foss as aw
# Load a Word document
doc = aw.Document("contract.docx")
# Convert to all output formats
doc.save("contract.md", aw.SaveFormat.MARKDOWN)
doc.save("contract.pdf", aw.SaveFormat.PDF)
doc.save("contract.txt", aw.SaveFormat.TEXT)
# Extract text for processing
text = doc.get_text()
print(f"Document contains {len(text)} characters")
الصيغ المدعومة
| التنسيق | الامتداد | قراءة | كتابة |
|---|---|---|---|
| DOCX | .docx | ✓ | — |
| DOC | .doc | ✓ | — |
| RTF | .rtf | ✓ | — |
| TXT | .txt | ✓ | — |
| Markdown | .md | ✓ | ✓ |
| — | ✓ |
المصدر المفتوح والترخيص
Aspose.Words FOSS for Python تم إصداره بموجب رخصة MIT. يمكنك استخدامه في المشاريع الشخصية والداخلية والتجارية دون رسوم ترخيص. الشيفرة المصدرية متاحة على GitHub.