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)