用 Python 将 HTML 转换为 PDF

PDF 文件是一种固定布局的文档，包括文本、图形、超链接、按钮、表单字段、多媒体和其他需要显示的信息。PDF 文件具有很高的安全性，允许使用密码保护、加密和数字签名来保护敏感信息。PDF 还具有普遍可访问性，无需特定软件即可在任何设备上轻松查看。此外，PDF 文件结构紧凑，可将高质量文件压缩到较小尺寸，非常适合共享和存储。

在本指南中，您将了解如何使用 Aspose.HTML for Python 通过 .NET 将 HTML 文档转换为便携文档格式(PDF)文件格式。我们将详细介绍如何使用 Converter 类的 convert_html() 方法将 HTML 转换为 PDF，以及如何应用 PdfSaveOptions。此外，您还可以尝试使用在线 HTML 转换器来测试 Aspose.HTML 的功能并即时转换 HTML。

要继续学习本教程，请在您的 Python 项目中 安装并配置 Aspose.HTML for Python via .NET。我们的代码示例将帮助您使用 Python 库将 HTML 转换为 PDF 并生成 PDF 文件。

用一行代码将 HTML 转换为 PDF

Converter 类的方法主要用于将 HTML 代码转换成各种格式的最简单方法。只需一行代码，您就可以在 Python 应用程序中将 HTML 转换为 PDF！

# Convert HTML to PDF using Python

import aspose.html.converters as conv
import aspose.html.saving as sav

# Convert HTML to PDF
conv.Converter.convert_html("document.html", sav.PdfSaveOptions(), "output.pdf")

在线 HTML 转换器

您可以通过 .NET 测试 Aspose.HTML for Python 的功能，并实时执行 HTML 转换。只需从本地文件系统或 URL 中加载 HTML 文件，选择所需的输出格式，然后运行所提供的代码示例即可。示例使用默认保存选项，转换过程简单。转换完成后，您将立即收到所选格式的转换文件。

使用 PdfSaveOptions 将 HTML 转换为 PDF

使用 Aspose.HTML for Python via .NET，您可以通过编程转换文件，并完全控制各种转换参数。要使用指定的 PdfSaveOptions 将 HTML 转换为 PDF，您需要遵循以下几个步骤：

1. 使用 HTMLDocument 类的 HTMLDocument() 构造函数之一加载 HTML 文件。在上面的示例中，我们从文件中初始化了一个 HTML 文档。
2. 创建一个新的 PdfSaveOptions 对象并指定所需的属性。PdfSaveOptions 类提供了大量属性，可让你完全控制各种参数，并改进将 HTML 转换为 PDF 的过程。
3. 使用转换器类的 convert_html() 方法。在下面的示例中，你需要将 HTMLDocument、PdfSaveOptions 和输出文件路径传递给 convert_html() 方法。

下面的 Python 代码示例展示了如何使用 PdfSaveOptions，创建带有自定义保存选项的 PDF 文件：

# Convert HTML to PDF in Python with custom settings

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.drawing as dr
import aspose.pydrawing as pd
import aspose.html.rendering.pdf.encryption as rpe


# Setup directories and define paths
output_dir = "output/"
input_dir = "data/"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)
document_path = os.path.join(input_dir, "document.html")
save_path = os.path.join(output_dir, "document-options.pdf")

# Load an HTML document from a file or URL
doc = ah.HTMLDocument(document_path)

# Initialize saving options
options = sav.PdfSaveOptions()
options.page_setup.any_page = dr.Page(dr.Size(800, 600), dr.Margin(10, 10, 10, 10))
options.css.media_type.PRINT
options.horizontal_resolution = dr.Resolution.from_dots_per_inch(100.0)
options.vertical_resolution = dr.Resolution.from_dots_per_inch(100.0)
options.background_color = pd.Color.bisque
options.is_tagged_pdf = True
options.jpeg_quality = 90

doc_info = options.document_info
doc_info.title = "Aspose HTML Example"
doc_info.author = "Your Name"
doc_info.subject = "PDF Conversion"
doc_info.keywords = "Aspose, HTML, PDF"

options.encryption = rpe.PdfEncryptionInfo(
    user_password="user123",
    owner_password="owner123",
    permissions=rpe.PdfPermissions.PRINT_DOCUMENT | rpe.PdfPermissions.EXTRACT_CONTENT,
    encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
)

# Convert HTML to PDF
conv.Converter.convert_html(doc, options, save_path)

在本例中，我们使用保存选项将 HTML 文档转换为 PDF 文件。这个过程包括初始化 HTML 文档、设置页面大小和 css 媒体类型等自定义保存选项，然后执行转换。最后，将转换后的 PDF 文件保存到指定的输出目录。

您可以通过试用我们的产品来评估转换质量。下图显示了将 aspose.html 文件转换为 PDF 格式的结果：

PdfSaveOptions 类

Aspose.HTML for Python via .NET 提供了 PdfSaveOptions类，使您可以对如何以 PDF 格式保存文档进行更多控制。该类的某些属性继承了基类的属性，如 PdfRenderingOptions 或 RenderingOptions。使用 PdfSaveOptions 可以自定义渲染过程；可以指定页面大小、页边距、文件权限、Css等。以下是 PdfSaveOptions 中可用属性的说明：

• page_setup – 该属性提供对 PageSetup 对象的访问，该对象用于配置输出 PDF 页面的布局和设置，以适应特定的打印或显示要求。
• horizontal_resolution – 该属性控制处理过程中使用的内部图像和 HTML 中包含的任何外部图像的水平分辨率。默认设置为 300 dpi。
• vertical_resolution – 与 horizontal_resolution 类似，该属性管理 PDF 生成过程中内部和外部图像的垂直分辨率。与水平分辨率一样，它的默认值也是 300 dpi。
• background_color – 该属性设置或检索填充每个 PDF 文档页面的背景颜色。默认值为透明色，但可根据品牌或审美偏好进行自定义，以确保所有页面的一致性。
• css – 该属性使用一个 CssOptions 对象来配置在 HTML 转换为 PDF 的过程中对 CSS 属性的处理。它允许精确控制如何在生成的 PDF 中解释和应用 HTML 中的样式。
• document_info – 该属性包含有关输出 PDF 文档的元数据和信息，如标题、作者、主题和关键字。这些元数据有助于文档管理、索引编制和可搜索性，使 PDF 文件内容更丰富、更有条理。
• form_field_behaviour – 该属性指定生成的 PDF 中交互式表单字段的行为。
• jpeg_quality – 该属性决定嵌入 PDF 文档的图像所使用的 JPEG 压缩质量。默认质量设置为 95，在图像保真度和文件大小之间取得了良好的平衡。通过设置此属性，您可以根据具体需要优化文件大小或图像质量。
• encryption – 该属性提供有关 PDF 文档加密的详细信息，包括密码保护和权限设置。如果未配置该属性，则不会应用加密，但设置该属性可以安全地分发和控制对敏感 PDF 内容的访问。
• is_tagged_pdf – 设置为 true 时，将在 PDF 文档中创建标记布局，从而提高残疾用户的可访问性。这可确保内容结构合理，可使用辅助技术进行导航，并符合可访问性标准。

HTML 转换为 PDF 和 PDF 扁平化

Aspose.HTML for Python via .NET提供了 PdfSaveOptions 类的 form_field_behaviour属性，用于在从HTML或MHTML转换为PDF文档后对其进行扁平化处理。该属性用于指定 PDF 文档中表单域的行为。如果值设置为 FormFieldBehaviour.FLATTENED，PDF 文档中的所有表单字段都将被扁平化。

# Flatten PDF during HTML to PDF conversion using Python

import os
import aspose.html as ah
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.rendering.pdf as rp

# Setup directories and define paths
data_dir = "data/"
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)

source_path = os.path.join(data_dir, "SampleHtmlForm.html")
result_path = os.path.join(output_dir, "form-flattened.pdf")

# Load an HTML document
doc = ah.HTMLDocument(source_path)

# Initialize PdfSaveOptions
options = sav.PdfSaveOptions()
options.form_field_behaviour = rp.FormFieldBehaviour.FLATTENED

# Convert HTML to PDF
conv.Converter.convert_html(doc, options, result_path)

如何将 HTML 转换为 XPS

Aspose.HTML for Python via .NET 支持 HTML 到 XPS 的转换。为此，您应使用 XpsSaveOptions 获得保存选项对象，并将其传递给convert_html()方法：

options = sav.XpsSaveOptions()

使用 XpsSaveOptions 可以自定义渲染过程；您可以指定 page_setup、 background_color、 css、 horizontal_resolution 和 vertical_resolution 属性。

下载 Aspose.HTML for Python via .NET库，即可成功、快速、轻松地将 HTML、MHTML、EPUB、SVG 和 Markdown 文档转换为最流行的格式。

您可以从 GitHub 下载完整的示例和数据文件。

Aspose.HTML 提供免费的在线 HTML 到 PDF 转换器，可将 HTML 高质量、方便快捷地转换为 PDF。只需上传、转换您的文件，几秒钟就能得到结果！