Quickstart
شروع سریع
این صفحه چرخهٔ اصلی ایجاد/تغییر/ذخیره/بارگذاری مجدد را مرور می‌کند: یک PDF دو‑صفحه‌ای بسازید، برای هر صفحه با استفاده از Annotation 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)