العمل مع PDF Writer
العمل مع PDF Writer
Aspose.Words FOSS for Python exports documents to PDF through a dedicated rendering pipeline. The pipeline converts each LDM element — paragraphs, runs, shapes, and tables — into PDF output using specialized renderers.
تصدير PDF الأساسي
حفظ أي مستند محمول إلى PDF باستخدام save() الطريقة:
import aspose.words_foss as aw
doc = aw.Document("input.docx")
doc.save("output.pdf")يتم تحديد شكل الحفاظ تلقائياً من امتداد الملف. للسيطرة الصريحة، استخدم SaveFormat:
import aspose.words_foss as aw
doc = aw.Document("input.doc")
doc.save("output.pdf", aw.SaveFormat.PDF)استخدام PdfSaveOptions
قم بتهيئة مخرج PDF باستخدام: PdfSaveOptions:
import aspose.words_foss as aw
from aspose.words_foss.saving import PdfSaveOptions
doc = aw.Document("input.docx")
opts = PdfSaveOptions()
doc.save("output.pdf", opts)خط أنابيب تقديم PDF
يستخدم كاتب PDF أربعة برامج تقديم متخصصة داخلياً:
| المُصدر | المقبضات |
|---|---|
ParagraphRenderer | يعرض فقرات LDM في PDF يتعامل مع التوجيهي والفاصل والتقليص |
RunRenderer | تصدر تشغيلات مُنسَخة قطاعات نصية مع الخطوط والألوان والروابط |
ShapeRenderer | يعرض الأشكال والصور، وعناصر الموقع |
TableRenderer | تصدر جداول LDM حدود الخلايا، والاندماج، والتغطية |
تعمل هذه المعدات معاً لإنتاج النسخة النهائية من PDF. تتفاعل معهم بشكل غير مباشر عبر Document.save().
تحويل صيغ متعددة إلى PDF
يوافق كاتب PDF على إدخال من أي قارئ مدعوم (DOCX، DOC، RTF، TXT، Markdown):
import aspose.words_foss as aw
for input_file in ["report.docx", "legacy.doc", "notes.rtf", "readme.txt"]:
doc = aw.Document(input_file)
pdf_name = input_file.rsplit(".", 1)[0] + ".pdf"
doc.save(pdf_name)
print(f"Saved {pdf_name}")نصائح وأفضل الممارسات
- استخدام
PdfSaveOptionsعندما تحتاج إلى تخصيص مخرج PDF خارج الافتراضات. - لتحويل الدفعات، تحميل وحفظ في حلقة العرض غير ذي حالة ويمكن إعادة الاستخدام عبر المستندات.
- يحافظ كاتب PDF على الأحرف الدهنية والمتجهة، والتوضيحات، وحجم الخطوط والألوان من الوثيقة المصدر.
- تجميع خلايا الجدول (
CellMerge) يتم تقديمها بشكل صحيح في مخرج PDF. - اختبار مع الوثائق التمثيلية قبل نشر إلى الإنتاج المخططات المعقدة قد تحتاج إلى تعديل.
القضايا الشائعة
| القضية | السبب | إصلاح |
|---|---|---|
| الخطوط المختلفة في PDF | الخط غير متوفر على النظام | قم بتثبيت الخطوط المطلوبة أو استخدم بديل الخطوص |
| الجداول غير المرتبطة | هياكل الجدول المعقدة المفروشة | تبسيط التجميع في الملف المصدر |
| الصور المفقودة | بيانات الصورة غير مدمجة في المصدر | تأكد من أن الصور مدمجة، وليس مرتبطة خارجيًا. |
FAQ
ما هي صيغ الإدخال التي يمكن تصديرها إلى PDF؟?
يمكن تحميل ملفات DOCX وDOC وRTF وTXT وMarkdown وتخزينها كملفات PDF.
هل يدعم كاتب PDF عناوين الصفحة وأسفلها؟?
يتم تضمين العناوين الرئيسية والأسفل من الوثيقة المصدر في مخرج PDF عندما تكون موجودة في LDM.
هل يمكنني التحكم في حجم الصفحة و التوجه؟?
يتم الحفاظ على خصائص إعداد الصفحة (الحجم، التوجه، الهامش) من الوثيقة المصدر في PDF. Modify PageSetup في Document قبل حفظها لتغيير هذه القيم.
ملخص مرجع API
| الفئة / الطريقة | وصف |
|---|---|
PdfSaveOptions | خيارات حفظ المستندات كملفات PDF |
ParagraphRenderer | تصدر فقرات LDM إلى PDF |
RunRenderer | تصويب تشغيلات مُنسَخة (نص مع الخطوط، الألوان، الروابط) |
ShapeRenderer | يعرض الأشكال والصور، وعناصر الموقع |
TableRenderer | تصدر جداول LDM إلى PDF |
SaveFormat.PDF | ثابت لتنسيق حفظ PDF |
Document.save(path) | حفظ المستند إلى الشكل المحدد |