如何使用 IronPDF 在 Python 中輕鬆註釋 PDF

先決條件

在使用IronPDF對 PDF 文件進行註釋之前，請確保您已滿足以下先決條件：

1. Python：請確保您的電腦上已安裝 Python。 若要下載最新版本，請造訪 Python 官方網站。 2.安裝整合開發環境 (IDE)：在使用IronPDF處理 PDF 文件之前，您需要安裝一個整合開發環境 (IDE)。我們推薦使用PyCharm ，它是一款流行的 Python 整合開發環境 (IDE)。 如果你不想使用 PyCharm，也可以使用任何你喜歡的 IDE。

2. IronPDF庫：在終端機中使用以下指令安裝IronPDF庫：

   pip install IronPDF

   pip install IronPDF

   SHELL

   安裝IronPDF軟體包

3. .NET 6.0 運行時： IronPDF for Python 依賴.NET 6.0 技術才能正常運作。 這表示您需要在電腦上安裝.NET 6.0 執行環境才能有效地使用IronPDF 適用於 Python。 最有可能的情況是，它會在專案運行時自動安裝IronPDF依賴項。

注意：使用 pip（Python 套件管理器）安裝IronPDF時，請務必確保IronPDF安裝路徑已包含在系統的PATH變數中。 這一步驟至關重要，它可以確保 pip 在安裝和使用過程中能夠找到IronPDF軟體包及其相關組件。

步驟 1：導入IronPDF庫

第一行從IronPDF庫導入所需的模組，從而可以存取 PDF 操作和註解所需的類別和函數。

from ironpdf import PdfDocument, TextAnnotation

from ironpdf import PdfDocument, TextAnnotation

步驟 2：載入現有 PDF 文檔

在此步驟中，使用PdfDocument類別載入名為"existing.pdf"的現有 PDF 檔案。 本文檔將作為新增註解的基礎。 此外，也要設定要新增受支援的註解類型的頁面索引。

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

# Load the PDF document and set the target page index for annotation
pdf = PdfDocument("existing.pdf")
pageIndex = 0

步驟 3：設定註解參數

以下程式碼定義了將新增至 PDF 中的文字註解的各種屬性。 這些屬性提供了有關註解外觀和行為的資訊：

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

# Create a text annotation and configure its properties
annotation = TextAnnotation(pageIndex)
annotation.Title = "This is the major title"
annotation.Subject = "This is a subtitle"
annotation.Contents = "This is the long 'sticky note' comment content..."
annotation.Icon = TextAnnotation.AnnotationIcon.Help
annotation.X = 150
annotation.Y = 200
annotation.Width = 200
annotation.Height = 50
annotation.Opacity = 0.9
annotation.Printable = False
annotation.Hidden = False
annotation.OpenByDefault = True
annotation.ReadOnly = False
annotation.Rotatable = True

以下是每個屬性的含義：

*註解：*設定註解變數並聲明註解類型。 標題：新註釋的主要標題。 主題：關於註釋的副標題或附加資訊。 內容：**註解的主要內容類似於"便籤"評論。 *圖示：與註釋關聯的視覺圖示（在本例中為幫助圖示）。

• X和Y：註釋在頁面上左上角的座標。 *寬度和高度：*註解邊界框的尺寸。 不透明度：註釋的不透明度等級（範圍從 0 到 1）。 可列印：是否應列印註解。 隱藏：**註解是否初始隱藏。
• OpenByDefault：註解是否預設開啟。
• ReadOnly：註解是否為唯讀。 *可旋轉：註解是否可以旋轉。

如需更多註解類型和屬性，請造訪此程式碼範例頁面。

步驟 4：在 PDF 中新增註釋

以下程式碼行將建立的文字註解新增至 PDF 文件中的特定頁面：

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

# Add the text annotation to the specified page in the PDF document
pdf.Annotations.Add(annotation)

步驟 5：儲存附註解的 PDF 文件

最後，使用SaveAs方法儲存新增了註解的更新後的 PDF 文件：

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

# Save the PDF document with the new annotations
pdf.SaveAs("annotated.pdf")

步驟 6：運行腳本

現在，讓我們把所有程式碼放在一起，然後在之前建立的 PyCharm 專案中執行腳本。

1. 若要在 PyCharm 中執行腳本，請在腳本編輯器中的任何位置按滑鼠右鍵，然後選擇"執行annotatePDF" 。
2. PyCharm 將執行該腳本，您將在 IDE 底部的執行控制台中看到輸出和任何潛在的錯誤。
3. 腳本完成後，您可以在專案所在的同一目錄中找到附註解的 PDF 檔案（"annotated.pdf"）。

輸出：

輸出的PDF文件