Wkhtmltopdf Python 与 IronPDF for Python 的比较

1.导言

PDF 在现代数字工作流程中发挥着至关重要的作用，是文档存储和共享的标准格式。 在Python中，开发者通常会使用功能强大的库，如wkhtmltopdf和IronPDF来生成和操作PDF文件。 这两个库都具有不同的特点和功能，可满足 PDF 生成领域的不同需求。 在本比较中，我们将探讨每个库的优势和用例，帮助开发人员做出明智的选择。

2.什么是 wkhtmltopdf？

2.1 概述

wkhtmltopdf 是一个使用 WebKit 渲染引擎将 HTML 或其他标记语言转换为 PDF 的命令行工具。 Python 开发者通常使用 pdfkit 库，作为围绕 wkhtmltopdf 的简单 Python 包装器，将其无缝集成到他们的项目中。 现在，python3-wkhtmltopdf 包还为 wkhtmltopdf 命令行工具提供了一个 Python 包装器，使在 Python 脚本中使用 wkhtmltopdf 更加方便。原来的 wkhtmltopdf Python 包已不再维护。

2.2 主要功能

2.2.1 HTML 到 PDF 的转换

wkhtmltopdf 擅长将 HTML 内容转换为 PDF，同时保留样式、布局和图像。 其简单明了的方法使其适用于以 HTML 转 PDF 为主要要求的场景。

2.2.2 命令行界面

作为一款命令行工具，wkhtmltopdf 可轻松编写脚本，并可集成到各种工作流程中。 它对批量 PDF 生成过程的自动化尤其有用。

2.2.3 CSS 样式和 JavaScript 支持

wkhtmltopdf 支持高级 CSS 风格，并可在转换过程中执行 JavaScript，从而在生成的 PDF 中提供丰富的动态内容。

2.2.4 灵活性和定制

wkhtmltopdf 在页面大小、方向和其他布局设置方面具有灵活性。 开发人员可以调整这些参数，以便在生成的 PDF 中实现所需的外观和感觉。

2.2.5 部署和依赖性

该工具不受外部库和依赖关系的影响，可简化部署。 不过，用户需要确保 wkhtmltopdf 二进制文件在其环境中可用。

3.用于 Python 的 IronPDF

3.1 概述

IronPDF 是一个多功能的Python库，旨在方便实现PDF的生成、编辑和操作。 它提供了一系列处理 PDF 文件的功能，如从 HTML 生成 PDF、将 HTML 转换为 PDF、向现有 PDF 添加文本和图像以及从 PDF 文档中提取内容。 它在 .NET Framework 中特别受欢迎，其 Python 版本旨在为 Python 开发人员带来类似的功能。

3.2 关键功能

• HTML到PDF转换：IronPDF 擅长将HTML转换为PDF，提供诸如CSS样式、JavaScript执行以及自定义页眉和页脚等功能。 它提供了多种转换 HTML 内容的方法，包括 HTML 字符串、HTML 文件和 URL。
• 编辑和操作：IronPDF 的一个显著特点是其编辑现有 PDF 文件的能力。 开发人员可以在 PDF 文档中添加文本、图像、注释等内容，使其成为一个全面的 PDF 操作解决方案。
• 安全功能：IronPDF 包括强大的安全功能，例如密码保护、加密和在PDF文档上设置权限。 这些功能对于安全处理敏感信息至关重要。
• 可定制渲染：使用IronPDF的开发人员可以对渲染过程进行细致的控制。 可以配置自定义页眉、页脚、页边距和用于转换的特定 HTML 部分，以实现精确的 PDF 输出。
• 部署和依赖项：IronPDF 无缝集成到各种 Python 环境中，包括 ASP.NET、MVC、Windows Forms 和 WPF。 它同时支持 .NET Core 和 Framework，因此适用于不同类型的项目。此外，它还可与 Azure 等云服务配合使用。

4.创建 Python 项目

4.1 设置 Python

确保您的系统已安装 Python。 您可以从Python官网下载Python。

4.2 在 PyCharm 中创建项目

在创建 Python 项目时，可以使用任何集成开发环境，这里我将使用著名的 Python 集成开发环境 PyCharm。您也可以使用任何集成开发环境，甚至是文本编辑器。

1. 打开 PyCharm： 在您的计算机上启动 PyCharm。

2. 创建新项目：在欢迎屏幕上点击“创建新项目”或在IDE中转到文件 > 新项目。

3. 设置项目位置：指定项目目录，并可选择启用“为项目创建目录”。

4. 选择解释器：选择一个现有的Python解释器或创建一个新的虚拟环境。

5. 配置项目：设置项目类型、内容根目录和源根目录（通常默认设置就可以）。

6. 点击“创建”：点击“创建”按钮以创建项目。

   

5.安装 wkhtmltopdf 实用程序

下载并安装 wkhtmltopdf

访问wkhtmltopdf 下载页面，并下载适合您的操作系统的安装程序。

安装 wkhtmltopdf

请按照针对您的特定操作系统提供的安装说明进行操作。 如果您使用的是 Windows 系统，请确保将其添加到 PATH 环境变量中，以便在命令行的任何位置访问它。

• 在 macOS 上：使用 Homebrew 安装 wkhtmltopdf：

  :InstallCmd brew install --cask wkhtmltopdf

  :InstallCmd brew install --cask wkhtmltopdf

• 在 Debian/Ubuntu 上：使用APT安装 wkhtmltopdf：

  :InstallCmd sudo apt-get install wkhtmltopdf

  :InstallCmd sudo apt-get install wkhtmltopdf

验证安装

打开一个新的终端或命令提示符，键入 wkhtmltopdf 以确保该工具已正确安装。 您应该看到有关可用选项的信息。

通过 pip 安装 wkhtmltopdf python 软件包

一种与 wkhtmltopdf 交互的流行 Python 库叫做 pdfkit。 使用以下命令将其安装到您的生产项目中：

:InstallCmd pip install pdfkit

:InstallCmd pip install pdfkit

6.安装 IronPdf

通过 pip 安装 IronPDF： 在 PyCharm 中打开终端或命令提示符，并运行以下命令以使用 pip 安装 IronPDF：

pip install ironpdf

您还可以从IronPDF网站的下载部分下载特定于您的平台的Python包，网址为https://ironpdf.com/python/

7.比较

在本次比较中，首先，我们将看看如何使用 wkhtmltopdf lib 和 IronPDF lib 从 HTML 创建 PDF 文档。 我们将了解如何根据以下内容生成 PDF：

1. HTML字符串转PDF

2. HTML 文件转 PDF

3. URL 到 PDF

   此外，我们还将探讨这两个库提供的一些可选参数和功能。

7.1 使用 IronPDF 创建 PDF 文件

首先，我们将看看IronPDF如何无缝渲染HTML字符串、文件和URL为PDF，利用其ChromePdfRenderer引擎。

7.1.1 将 HTML 字符串转换为 PDF

from ironpdf import *      
# Instantiate Renderer
renderer = ChromePdfRenderer()
# Create a PDF from an HTML string using Python
pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
# Export to a file or Stream
pdf.SaveAs("output.pdf")

py

以下是 HTML 字符串转换为 PDF 的输出结果：

7.1.2 将 HTML 文件转换为 PDF

from ironpdf import *      
# 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("output.pdf")

py

以下是 HTML 文件转换为 PDF 的输出结果：

7.1.3 将 HTML URL 转换为 PDF

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

py

7.2 wkhtmltopdf

现在，我们将使用wkhtmltopdf和Pdfkit软件包将HTML字符串、文件和URL转换为PDF。 首先，您需要将 PATH 设置为 wkhtmltopdf 库的安装路径，或在代码前手动添加配置：

config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')

py

7.2.1 将 HTML 字符串转换为 PDF

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_string('<h1>Hello World!</h1>', 'out.pdf', configuration=config)

py

以下是转换为 PDF 格式的 HTML 字符串：

7.2.2 将 HTML 文件转换为 PDF

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_file('example.html', 'index.pdf', configuration=config)

py

以下是转换为 PDF 格式的 HTML 文件：

7.2.3 将 HTML URL 转换为 PDF

import pdfkit
config = pdfkit.configuration(wkhtmltopdf='PATH-to-WKHTMLTOPDF-EXECUTABLE-FILE')
pdfkit.from_url('https://google.com', 'example.pdf', configuration=config)

py

7.3 对比

在对上述代码和两个库提供的功能进行总体比较后，下面对它们生成 PDF 的代码和功能进行详细比较：

1.易用性

IronPDF 提供了简洁明了的 Pythonic API，可直接用于 HTML 到 PDF 的转换。 代码要简洁、富有表现力。

wkhtmltopdf 简单易用，但与 IronPDF 相比，语法可能不那么 Python。 此外，它主要是一个命令行工具，要在 Python 环境中成功运行 wkhtmltopdf，还需要依赖另一个 Python 软件包。

2.灵活性

IronPdf 在渲染、编辑和保护 PDF 方面提供了大量自定义选项，具有高度的灵活性。 这是一个代码示例，您可以创建可选参数作为HTML 渲染设置：

from ironpdf import *          
    # Instantiate Renderer
    renderer = ChromePdfRenderer()
    # Many rendering options to use to customize!
    renderer.RenderingOptions.SetCustomPaperSizeInInches(12.5, 20)
    renderer.RenderingOptions.PrintHtmlBackgrounds = True
    renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
    renderer.RenderingOptions.Title = "My PDF Document Name"
    renderer.RenderingOptions.EnableJavaScript = True
    renderer.RenderingOptions.WaitFor.RenderDelay(50) # in milliseconds
    renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
    renderer.RenderingOptions.FitToPaperMode = FitToPaperModes.Zoom
    renderer.RenderingOptions.Zoom = 100
    renderer.RenderingOptions.CreatePdfFormsFromHtml = True
    # Supports margin customization!
    renderer.RenderingOptions.MarginTop = 40 # millimeters
    renderer.RenderingOptions.MarginLeft = 20 # millimeters
    renderer.RenderingOptions.MarginRight = 20 # millimeters
    renderer.RenderingOptions.MarginBottom = 40 # millimeters
    # Can set FirstPageNumber if you have a cover page
    renderer.RenderingOptions.FirstPageNumber = 1 # use 2 if a cover page will be appended
    # Settings have been set, we can render:
    renderer.RenderUrlAsPdf("https://www.wikipedia.org/").SaveAs("my-content.pdf")

py

wkhtmltopdf 可以灵活地完成基本的转换任务，但可能需要其他工具来进行更高级的 PDF 操作。 在此，PDFKit 提供了满足这一目的的渲染选项：

import pdfkit
options = {
    'page-size': 'Letter',
    'orientation': 'Landscape',
    'margin-top': '0.75in',
    'margin-right': '0.75in',
    'margin-bottom': '0.75in',
    'margin-left': '0.75in',
    'encoding': "UTF-8",
    'custom-header': [
        ('Accept-Encoding', 'gzip')
    ],
    'no-outline': None
}
pdfkit.from_file('index.html', 'index.pdf', options=options)

py

3.译文特点

IronPdf 提供 PDF/A 合规性、编辑、合并和安全设置等高级功能。 以下是IronPDF提供的密码、安全性和元数据选项和功能列表：

from ironpdf import *          
    # Open an Encrypted File, alternatively create a new PDF from Html
    pdf = PdfDocument.FromFile("encrypted.pdf", "password")
    # Edit file metadata
    pdf.MetaData.Author = "Satoshi Nakamoto"
    pdf.MetaData.Keywords = "SEO, Friendly"
    pdf.MetaData.ModifiedDate = Now()
    # The following code makes a PDF read-only and will disallow copy & paste and printing
    pdf.SecuritySettings.RemovePasswordsAndEncryption()
    pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key")
    pdf.SecuritySettings.AllowUserAnnotations = False
    pdf.SecuritySettings.AllowUserCopyPasteContent = False
    pdf.SecuritySettings.AllowUserFormData = False
    pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
    # Change or set the document encryption password
    pdf.SecuritySettings.OwnerPassword = "top-secret"  # password to edit the pdf
    pdf.SecuritySettings.UserPassword = "sharable"  # password to open the pdf
    pdf.SaveAs("secured.pdf")

py

wkhtmltopdf 更侧重于 HTML 到 PDF 的转换，缺少 IronPDF 提供的一些高级功能。

4.集成

IronPDF for Python 与 Python 环境无缝集成，易于部署。

wkhtmltopdf 需要 wkhtmltopdf 二进制文件，在部署过程中可能需要额外的考虑。

5.语法

• IronPDF 的语法简洁，与 Python 代码集成良好。
• wkhtmltopdf 的语法简单明了，但与 IronPDF 相比，可能会感觉与 Python 的集成度较低。

8.支持和文档

8.1 IronPDF

文档质量和可用性

IronPDF 因其全面且用户友好的文档而脱颖而出，满足初学者和经验丰富的开发者的需求。 文档包含详细指南、API 参考以及大量代码示例，帮助更顺畅地理解和实现该库在多种语言（如 Python、Java、C# 和 Node.js）中的功能。

支持选项

IronPdf 提供多种支持选项，确保开发人员及时获得帮助。 在翻译过程中，译员还需要提供一些帮助，包括通过电子邮件联系专门的支持团队、积极参与开发人员论坛，以及在网站上提供实时帮助的即时支持选项。

8.2 wkhtmltopdf

文档质量和可用性

wkhtmltopdf 是一个开源项目，在其官方 GitHub 存储库和其他在线平台上提供文档。 虽然文档涵盖了基本的用法和安装，但其深度或初学者友好性可能无法与某些商业替代品相提并论。

GitHub 问题和社区支持

wkhtmltopdf 的支持主要由社区驱动。 用户可以通过 GitHub 问题报告和寻求帮助，依靠社区讨论和论坛来解决问题。 该社区积极参与讨论，分享经验和解决方案。

9.许可模式

9.1 wkhtmltopdf

wkhtmltopdf 采用开源许可模式。 它是根据GNU Affero通用公共许可证（AGPL）分发的，这是一种免费和开源的软件许可证。 AGPL 是一种版权许可，要求软件的任何修改版本也必须在 AGPL 下发布。 以下是有关 wkhtmltopdf 许可证的要点：

开源

wkhtmltopdf 是免费提供的开源软件，允许用户查看、修改和发布源代码。

AGPL 许可

根据 GNU AGPL 发布，要求对代码所做的任何更改都必须根据相同的许可证发布。

免费使用

用户可以自由下载、使用和修改软件，无需支付任何许可费用。

版权条款

AGPL 的版权保护条款确保任何衍生作品也必须是开源的。

9.2 IronPDF

IronPDF 采用商业授权模式。 IronPdf 的许可基于不同的版本，每个版本都能满足特定的需求和使用场景。 现有版本包括

Lite 版本

• 以一次性费用$749用于云部署定价。
• 专为有基本 PDF 处理要求的小型项目或团队而设计。

专业版

• 以一次性费用$1,999定价用于云使用。
• 适合需要更高级 PDF 特性和功能的专业开发人员。

无限制版

• 以$3,999的云部署一次性费用定价。

• 非常适合大型企业使用，可提供广泛的功能，且没有使用限制。

  

  IronPDF 许可证是永久性的，即不会过期，开发人员可根据所选版本获得更新和支持。 许可模式为开发人员提供了灵活性，他们可以选择符合其项目要求的版本。 有关许可和附加组件的更多信息，请访问许可页面。

10.结论

总之，在对 wkhtmltopdf 和 IronPDF for Python 进行全面比较后，IronPDF 显然是具有高级 PDF 要求的项目的上佳选择。 虽然 wkhtmltopdf 非常适合直接进行 HTML 到 PDF 的转换任务，因为它简单易用，而且具有命令行界面，但在面对更复杂的 PDF 操作时，它可能会显得力不从心，往往需要使用其他工具。

相反，事实证明 IronPdf 是一个突出的选择，尤其是对于要求更高水平的项目。 它擅长提供用户友好的 API，并配备了广泛的自定义选项。 这使得 IronPDF 成为要求全面 PDF 操作、编辑和强大安全功能的任务的理想解决方案。 其灵活性不仅仅局限于布局设置，还允许开发人员将其无缝集成到各种 Python 环境中。

IronPdf 的文档在深度和易读性方面都非常出色，为开发人员提供了全面的资源。 相比之下，依靠社区支持的 wkhtmltopdf 可能更适合熟悉社区论坛和自主解决问题的开发人员。

IronPDF在开发过程中免费使用，但生成的PDF上会有水印，并提供免费试用，以便在商业模式下完整测试其功能而没有水印。 从这里下载软件。