如何使用 IronPDF 在 Python 中輕鬆註釋 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 集成開發環境 (IDE)。 或者，如果您不想使用 PyCharm，可以選擇使用任何您喜好的 IDE。

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

   pip3 install IronPDF

   pip3 install IronPDF

安裝 IronPDF 套件

4. .NET 6.0 運行時： IronPDF for Python 依賴 .NET 6.0 技術運作正常。 這意味著您需要在計算機上安裝.NET 6.0 執行環境才能有效地使用IronPDF for Python。 在專案執行時，很可能會自動安裝 IronPDF 的相依性。

   注意：在使用 pip3（Python 套件管理工具）安裝 IronPDF 時，必須確保 IronPDF 的安裝路徑已包含在系統的PATH變數中。 這一步對於確保 pip 在安裝和使用期間能夠找到 IronPDF 套件及其相關組件是至關重要的。

在 PyCharm 中創建專案

首先在 PyCharm 中創建一個新項目：

1. 打開 PyCharm 並點擊「Create New Project」。

   

   PyCharm IDE

2. 選擇專案的位置並選擇適當的解釋器（Python）。

   

   建立一個新的 Python 專案

3. 點擊「建立」，專案即被建立。 將創建 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

步驟 3：設定註釋參數

以下程式碼行定義了將添加到 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

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

• 註解：設置註解變數並聲明註解類型。
• 標題：新註解的主要標題。
• 主題：有關註釋的副標題或補充資訊。
• 內容：註釋的主要內容，類似於「便利貼」評論。
• 圖示：與註釋相關的視覺圖示（在此情況下，是一個幫助圖示）。
• X和Y：註釋在頁面左上角的座標。
• 寬度和高度：註釋邊界框的尺寸。
• 不透明度：註釋的不透明度級別（範圍從 0 到 1）。
• 可列印：註釋是否應該被列印。
• 隱藏：註解是否初始設為隱藏。
• OpenByDefault：註解是否應預設開啟。
• ReadOnly：註釋是否為唯讀。

• 可旋轉: 註釋是否可以旋轉。

  欲了解更多註解類型和屬性，請訪問此代碼範例頁面。

步驟 4：將註解添加到 PDF

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

pdf.Annotations.Add(annotation)

pdf.Annotations.Add(annotation)

步驟 5：保存註解後的 PDF

最後，附加註釋的更新 PDF 文件將使用 SaveAs 方法儲存：

pdf.SaveAs("annotated.pdf")

pdf.SaveAs("annotated.pdf")

步驟 6：運行腳本

現在，讓我們把所有程式碼整合在一起，並在先前創建的 PyCharm 專案中執行該腳本。

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

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

3. 完成腳本後，您可以在與您的專案相同的目錄中找到註釋過的 PDF（"annotated.pdf"）。

   輸出：

   

   輸出 PDF 檔案

結論

通過遵循本文所述的步驟，您可以利用 IronPDF 的強大功能來自動化您的 PDF 註釋工作流程，並改善您的文件管理流程。 IronPDF 簡化了在 PDF 文檔中新增連結註釋及修改現有註釋的過程，無論這些註釋位於不同頁面或同一頁面，並提供了一套強大的工具，用於以程式化方式創建、修改和註釋。

此外，IronPDF 提供您建立互動式 PDF 文件、填寫和發送互動式表單、拆分和合併 PDF 文件、從 PDF 文件中提取文本和圖片、搜尋 PDF 文件中的特定詞彙、光柵化 PDF 頁面為圖片，將 PDF 轉換為 HTML，以及列印 PDF 文件。

立即開始嘗試 IronPDF，看看它如何改變您的文檔管理流程。 IronPDF 提供免費試用，讓您在購買許可證之前可以測試完整功能。 授權 起始於 $749，並可選擇添加實用的額外功能。 從官方網站下載 IronPDF for Python，立即開始提升您的 PDF 專案。