如何在Python中创建PDF文件

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

使用Python自动创建PDF文档使开发者能够作为其应用程序的一部分生成PDFs。 此功能在多种情况下证明十分有益,包括按需生成发票、报告或其他类型的PDF文件。

本指南着重介绍如何在Python脚本中使用IronPDF来编程创建PDF文件。

Python PDF 库:IronPDF

IronPDF是一个功能强大的Python库,专为从HTML创建PDF文档而设计。 其用户友好的 API 使得生成和自定义包含各种功能的 PDF 文件变得简单,包括:

  1. 添加文本、图片和其他类型的内容

  2. 选择字体、颜色以及控制文档布局和格式。

    IronPDF可以无缝集成到.NET, JavaPython应用程序,实现跨多个平台的灵活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 下载微软官方网站.

  2. Python:从官方Python网站下载并安装最新版本的Python 3.x:https://www.python.org/downloads/

    在安装过程中,请确保选择添加Python到系统PATH的选项,这将使其可以从命令行访问。

  3. Pip:从Python 3.4及以后的版本开始,Pip通常会与Python安装包一起捆绑。 然而,根据您的Python安装情况,您可能需要检查pip是否已安装或需要单独安装。

  4. IronPDF库:IronPDF库可以通过pip添加。使用以下命令通过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文件,您需要有效的许可密钥。 购买 许可证密钥或 获得免费试用 许可证密钥。 否则,请继续下一步,免费生成带水印的新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 字符串的内容。

在Python中从HTML文件生成PDF

要在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 可以像网页浏览器一样渲染包括任何关联的 CSS 和 JavaScript 在内的 HTML 元素。 这确保了生成的PDF中内容的准确呈现。

最后,使用 SaveAs 方法将生成的PDF保存到系统上的特定位置,类似于之前的示例。

在Python中从URL创建PDF

要在Python中从网页创建PDF文档,请使用RenderUrlAsPdf方法。 只需将所需网页的URL作为参数提供给方法,如下面的代码片段所示:

# 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 代码示例page.

探索 PDF 格式化选项

要自定义PDF文件的格式,您可以使用RenderingOptions属性。 此类提供各种可配置的设置,以实现您的PDF文档所需的布局和外观。 您可以修改的一些设置包括页面方向、页面大小、边距大小等。 将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,简化了从各种源(包括 HTML 文件、XML 文档、URL 等)创建 PDF 的过程。 无论您是在生成报告、发票还是任何其他类型的文档,IronPDF 都提供了完成任务所需的必要工具。

IronPDF是一个商业库,需要有效的许可证。 它有一个商业许可从$749开始。 要评估其在生产环境中的功能,您可以利用 免费试用 由IronPDF提供。

*下载软件产品。