Quickstart
الدليل السريع للبدء
تستعرض هذه الصفحة دورة الإنشاء/التعديل/الحفظ/إعادة التحميل الأساسية: بناء ملف PDF من صفحتين، إرفاق تعليق توضيحي لكل صفحة باستخدام API المحدث، توليد المظهر المرئي للتعليقات، حفظ المستند، ثم إعادة تحميله للتأكد من بقاء التغييرات بعد جولة النقل.
المتطلبات المسبقة
| المتطلب | التفصيل |
|---|---|
| Python | 3.11 أو أحدث |
| Package | aspose-pdf-foss-for-python مثبت (Installation) |
1. إنشاء مستند وإضافة صفحات
Document() بدون أي معاملات ينشئ ملف PDF فارغ في الذاكرة. document.pages هو PageCollection قابل للتعديل؛ استدعاء add() يضيف صفحة فارغة.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. إضافة التعليقات التوضيحية وتوليد مظهرها
خاصية annotations لكل صفحة هي AnnotationCollection. add() تأخذ اسم نوع فرعي، مستطيل (left, bottom, right, top)، نص المحتوى، وقاموس اختياري properties يحتوي على قيم مفاتيح بأسماء PDF، وتعيد الـ Annotation الجديد. generate_appearance() تُظهر المحتوى البصري للتعليق التوضيحي بحيث يُعرض بشكل صحيح في عارض PDF.
document.pages[0].annotations.add("Square", (0, 0, 50, 50), "")
line = document.pages[1].annotations.add(
"Line", (0, 0, 50, 50), "", properties={"L": [0, 0, 50, 50]}
)
line.generate_appearance()3. حفظ وإعادة تحميل
Document.save يقبل مسار ملف (أو تدفق قابل للكتابة). Document.load_from يقرأ المستند مرة أخرى من مسار، بايتات، أو تدفق.
document.save("quickstart.pdf")
reopened = Document()
reopened.load_from("quickstart.pdf")
print("Reloaded pages:", reopened.page_count)
print("Has appearance:", reopened.pages[1].annotations[0].has_appearance)