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

在當今的數位時代，PDF 是文件的支柱，從法律合同到學術論文。但是，當你需要在 PDF 內容中添加評論或強調關鍵點時該怎麼辦呢？這就是 PDF 注釋的用武之地。

所以，如果你想學習如何使用 IronPDF for Python 庫向你的 PDF 文件添加注釋，那麼請繼續閱讀，因為今天我們將學習如何做到這一點。

了解 PDF 註釋

PDF 註釋是將額外的資訊、備註、標記或其他視覺元素添加到 PDF 文件的過程。註釋可作為提供背景、協作文件和增強內容可讀性的一種方式。常見的註釋類型包括文字評論、通過鏈接註釋添加鏈接、添加文件附件、標記、下劃線、刪除線、形狀，甚至添加圖片或印章。

IronPDF - 一個 Python PDF 圖書館

IronPDF 是一個受歡迎的 Python 庫，使開發人員能夠無縫地處理 PDF 文件。它提供了全面的功能集，包括 PDF 創建、操作和註釋。有了 IronPDF，您可以輕鬆將 PDF 生成和修改功能集成到您的 Python 應用程式中，讓您自動化任務並簡化文件工作流程。

IronPDF 支持各種註釋類型，使您能夠為您的 PDF 文件創建豐富且互動的閱讀體驗。無論您是想使用文字註釋添加文本說明、高亮顯示重要部分、使用文件附件類型附加其他 PDF 文件，還是甚至使用印章註釋將文件標記為 “核准” 或 “保密”，IronPDF 都能滿足您的需求。

先決條件

在我們開始使用 IronPDF 註釋 PDF 文件之前，請確保您已經具備以下先決條件：

1. Python: 確保您的電腦上已經安裝了 Python。要下載最新版本，請訪問官方的 Python 網站。

2. 安裝 IDE: 在您開始使用 IronPDF 處理 PDF 之前，您需要安裝一個 IDE。今天我們將使用 PyCharm, 一個受歡迎的集成開發環境 (集成開發環境) 適用於 Python。或者，如果您不想使用 PyCharm，您可以選擇任何您喜歡的 IDE。

3. IronPDF 庫： 在終端中使用以下命令安裝 IronPDF 庫：

   pip3 install IronPDF

   pip3 install IronPDF

4. .NET 6.0運行時： IronPDF for Python依賴於.NET 6.0技術才能正常工作。這意味著您需要擁有 .NET 6.0 執行階段 需在您的電腦上安裝，以便有效使用 IronPDF Python。很可能在項目執行時會與 IronPDF 依賴項一起自動安裝。

注意: 使用 pip3 安裝 IronPDF 時(Python 套件管理器)，確保IronPDF安裝路徑被包括在系統的PATH變數中是很重要的。這一步對於確保pip能在安裝和使用過程中定位到IronPDF軟件包及其相關組件至關重要。

在 PyCharm 中创建项目

让我们从在 PyCharm 中创建一个新项目开始：

1. 打开 PyCharm 并点击“Create New Project”。

   

2. 選擇您的專案位置並選擇適當的解釋器 (Python).

   

3. 點擊“Create”，專案就會被創建。同時會創建 main.py 檔案，我們將在那裡編寫執行代碼。

現在我們的專案已經設置好，讓我們繼續使用 IronPDF 來註釋 PDF。

在 Python 中註解 PDF 文件的步驟

第 1 步：匯入 IronPDF 庫

第一行匯入了來自 IronPDF 庫的必需模組，使我們能夠訪問進行 PDF 操作和註釋所需的類別和函數。

from ironpdf import *

from ironpdf import *

第2步：載入現有的PDF文件

在此步驟中，使用 PdfDocument 類別載入名為「existing.pdf」的現有PDF文件。此文件將作為添加註釋的基礎。同時，設定將要添加支援註釋類型的頁面索引。

pdf = PdfDocument("existing.pdf")
pageIndex = 0

pdf = PdfDocument("existing.pdf")
pageIndex = 0

第三步：設置註釋參數

以下幾行代碼定義了將添加到 PDF 的文字註釋的各種屬性。這些屬性提供了關於註釋外觀和行為的信息：

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

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

以下是每個屬性所代表的內容：

• Annotation: 設定註解變量並聲明註解類型。
• Title: 新註解的主要標題。
• Subject: 註解的副標題或其他信息。
• Contents: 註解的主要內容，類似「便條」評論。
• Icon: 與註解相關的圖示。 (在這種情況下，一個幫助圖示).
• X 和 Y：註解在頁面左上角的座標。
• 寬度 和 高度：註解邊界框的尺寸。
• 不透明度：註解的不透明程度 (從 0 到 1)。
• Printable: 註解是否應被列印。
• Hidden: 註解是否最初被隱藏。
• OpenByDefault: 註解是否應默認開啟。

• ReadOnly: 註解是否為只讀。

• Rotatable: 註解是否可旋轉。

欲了解更多註解類型及屬性，請訪問此處 程式碼範例頁面.

第四步：將註釋添加到PDF

以下程式碼將已創建的文字註釋添加到PDF文件的特定頁面：

pdf.Annotations.Add(annotation)

pdf.Annotations.Add(annotation)

第五步：保存帶有註解的 PDF

最後，使用 SaveAs 方法保存添加了註解的更新PDF文件：

pdf.SaveAs("annotated.pdf")

pdf.SaveAs("annotated.pdf")

第六步：執行腳本

現在，我們將所有代碼整合在一起，並在我們創建的 PyCharm 專案中運行腳本。

1. 要在 PyCharm 中運行腳本，右鍵點擊腳本編輯器中的任意位置，然後選擇執行annotatePDF。

2. PyCharm 會執行腳本，你將在 IDE 底部的執行控制台中看到輸出和任何潛在的錯誤。

3. 一旦腳本完成，你可以找到已註解的 PDF。 ("annotated.pdf") 在與您的專案相同的目錄中。

輸出：

結論

透過遵循本文中概述的步驟，您可以利用 IronPDF 的功能來自動化您的 PDF 註釋工作流程並改善您的文檔管理過程。IronPDF 簡化了在不同頁面或同一頁面上添加鏈接註釋和編輯現有註釋的過程，並為程式化的創建、修改和註釋提供了一套強大的工具。

立即開始試驗 IronPDF，看看它如何轉變您的文檔管理流程。IronPDF 提供一 免費試用 所以您可以在購買許可證之前測試其完整功能。 授權條款 起始價格為 749 美元，並可以選擇添加有用的附加功能。從這裡下載 IronPDF for Python 這裡 並立即開始提升您的 PDF 專案。