العمل مع 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)حفظ المستند إلى الشكل المحدد
 العربية