如何在Python中建立PDF檔案

This article was translated from English: Does it need improvement?
Translated
View the article in English

使用Python自動化建立PDF文件讓開發者能夠在他們的應用程式中生成PDF。在不同情況下,這項功能都非常有用,包括生成發票、報告或其他所需的PDF。

本操作指南著重於利用IronPDF在Python腳本中以編程方式創建PDF文件。

Python PDF 庫: IronPDF

IronPDF 是一個專為從 HTML 創建 PDF 文件而設計的強大 Python 庫。其使用者友好的 API 使生成和定制具有各種功能的 PDF 變得簡單,包括:

  1. 添加文本、圖片和其他類型的內容
  2. 選擇字體、顏色,並控制文檔的佈局和格式。

IronPDF 可以無縫地集成到 .NET, Java,和 Python 應用程式,實現跨多平台的多功能PDF生成。

除了強大的PDF生成功能外,IronPDF還提供了廣泛的功能範圍。這些功能包括文件格式轉換、從PDF中高效提取文字和數據,以及通過密碼加密保護PDF的能力。

在 Python 腳本中創建 PDF 文件的步驟

先決條件

要使用IronPDF python,請確保計算機已安裝以下先決條件軟體:

  1. .NET 6.0 SDK:要使用IronPDF Python,您需要在機器上安裝.NET 6.0 SDK,因為它依賴於IronPDF .NET庫。從以下網站下載.NET 6.0 SDK 官方Microsoft網站.

  2. Python:從官方 Python 網站下載並安裝最新版本的 Python 3.x:https://www.python.org/downloads/

在安裝過程中,請確保選中將 Python 添加到系統 PATH 選項,這將使其可以從命令行訪問。

  1. Pip:Pip 通常從 Python 3.4 及更高版本的安裝開始捆綁。然而,根據您的 Python 安裝情況,您可能需要檢查是否已安裝 pip 或單獨安裝它。

  2. IronPDF Library:可以使用 pip 添加 IronPDF 庫。使用下面的命令通過 pip 安裝 IronPDF:
 pip install ironpdf

請注意
在某些系統上,Python 2.x 可能仍是預設版本。在這種情況下,您可能需要明確使用 pip3 命令而不是 pip,以確保您使用的是適用於 Python 3 的 Pip。

撰寫程式碼前的重要步驟

首先,將以下語句添加到 Python 腳本的頂部。

# Import statement for IronPDF Python
from ironpdf import *
PYTHON

接下來,透過將授權金鑰分配給 License 的 LicenseKey 屬性,配置 IronPDF 有效的授權金鑰 (在任何其他代碼行之前).

# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
PYTHON

請注意
要建立沒有浮水印的 PDF,您需要有效的授權金鑰。購買 a license key or 獲取免費試用 授權金鑰。否則,繼續下一步以免費生成帶有浮水印的新PDF文件。

將 HTML 字符串轉換為 PDF 文件

使用 RenderHtmlAsPdf 方法,您可以從 HTML 字符串生成新的 PDF 文件。

只需將 HTML 標記作為 RenderHtmlAsPdf 方法的參數提供。IronPDF 會進行轉換,產生一個 PDF 文件 PdfDocument 實例。

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from a HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
PYTHON

一旦 HTML 字串成功轉換為 PDF 文件,請使用 SaveAs 方法將 PDF 儲存到本地系統中的路徑:

# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")
PYTHON

將建立一個名為 "htmlstring_to_pdf.pdf" 的 PDF 文件,保留原始 HTML 字串的內容。

從 HTML 檔案生成 PDF 檔案(使用 Python)

要在 Python 中將本地儲存的 HTML 檔案生成 PDF 文件,請遵循以下提供的代碼:

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")

# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")
PYTHON

在上面的代碼片段中,RenderHtmlFileAsPdf方法用於從 HTML 文件創建 PDF 文件。你需要提供一個字符串或路徑來指定 HTML 文件在文件系統中的位置。

IronPDF 會像網頁瀏覽器一樣渲染 HTML 元素,包括任何相關的 CSS 和 JavaScript。這確保了結果 PDF 文件中內容的精確表示。

最後,使用 SaveAs 方法將生成的 PDF 保存到系統上的特定位置,類似於前面的範例。

在 Python 中從網址建立 PDF

要在 Python 中從網頁建立 PDF 文件,請使用 RenderUrlAsPdf 方法。只需將所需網頁的 URL 作為該方法的參數,如以下代碼片段所示:

# 示例代碼
from IronPDF import RenderUrlAsPdf

pdf = RenderUrlAsPdf("https://www.example.com")
pdf.save("output.pdf")
PYTHON
# Instantiate Renderer
renderer = ChromePdfRenderer()

# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")

# Export to a file or Stream
pdf.SaveAs("url.pdf")
PYTHON

更多關於將網頁轉換為PDF資訊,請參閱 將 URL 轉換為 PDF 範例程式碼 頁面。

探索 PDF 格式化選項

要自訂 PDF 文件的格式,可以使用 RenderingOptions 屬性。這個類別提供了各種可配置的設置,以實現理想的佈局和外觀。其中包括可以修改的設置有頁面方向、頁面大小、邊距大小等等。在 RenderingOptions 中設置可用屬性來生成具備所需設置的 PDF 文件。請參閱此 範例程式碼 有關如何使用 RenderingOptions 的更多信息。

使用密碼保護 PDF 文件

要為 PDF 文件添加密碼保護,您可以利用 PdfDocument 對象的 SecuritySettings 屬性。首先,訪問 SecuritySettings 屬性,並將一個字串形式的密碼指定給 UserPassword 屬性。

例如,讓我們考慮在 "URL 轉 PDF" 範例中創建的 PDF 文檔:

pdf.SecuritySettings.UserPassword = "sharable"
pdf.SaveAs("protected.pdf")
PYTHON

PDF 文件已成功設置密碼保護。當嘗試打開文件時,將顯示密碼提示。只需輸入正確的密碼即可訪問 PDF 文件的內容。

了解更多關於附加安全性和元數據設定的信息 這裡.

完整原始碼

這個教程的完整原始檔如下:

# Import statement for IronPDF Python
from ironpdf import *

# Apply your license key
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1><p>This is an example HTML string.</p>")
# Export to a file or Stream
pdf.SaveAs("htmlstring_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an existing HTML file using Python
pdf = renderer.RenderHtmlFileAsPdf("example.html")
# Export to a file or Stream
pdf.SaveAs("htmlfile_to_pdf.pdf")

# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from a URL or local file path
pdf = renderer.RenderUrlAsPdf("https://ironpdf.com")
# Export to a file or Stream
pdf.SaveAs("url.pdf")

pdf.SecuritySettings.UserPassword = "sharable"
pdf.SaveAs("protected.pdf")
PYTHON

IronPDF 準確呈現所有圖像和文字,同時保留其格式。類似按鈕的互動元素仍可點擊,並且文本框在生成的 PDF 文件中保留可編輯性。

概要

在本指南中,我們探討了使用 IronPDF 庫在 Python 中創建 PDF 的過程。使用 IronPDF,開發人員可以輕鬆生成和操作 PDF 文件。

該庫提供了一個用戶友好的 API,簡化了從各種來源創建 PDF 的過程,包括 HTML 文件、XML 文檔、URL 等。無論您是在生成報告、發票還是任何其他文檔類型,IronPDF 都提供了必要的工具來高效地完成任務。

IronPDF 是一個商業庫,需要有效的許可證。它有一個 商業授權 開始於 $749。要在生產環境中評估其功能,您可以利用 免費試用 由 IronPDF 提供。下載 該軟體產品。