渲染设备 – 将 HTML 渲染为 PDF、XPS、DOCX 和图像

本文将介绍如何使用渲染设备 PdfDevice、 XpsDevice、 DocDevice 和 ImageDevice 将 HTML 渲染为 PDF、XPS、DOCX 和图像。在 Python 示例中，渲染过程使用的是默认渲染选项。要了解有关自定义输出的更多信息，请阅读 Rendering Options 一文。

了解 Aspose.HTML 中的渲染设备 – Rendering Devices

在 Aspose.HTML for Python via .NET 中，渲染设备代表一个 2D 绘图表面，通过 IDevice 接口实现。其主要目的是将 HTML 内容和支持的网络格式(MHTML、SVG 和 EPUB)转换为不同的输出格式。

Python API 提供以下渲染设备：

• PdfDevice – 将 HTML、MHTML、SVG 和 EPUB 渲染成 PDF。
• XpsDevice – 将 HTML、MHTML、SVG 和 EPUB 渲染成 XPS。
• DocDevice – 将 HTML、MHTML、SVG 和 EPUB 渲染为 DOCX。
• ImageDevice – 将 HTML、MHTML、SVG 和 EPUB 呈现为图像格式。

每个设备都有特定的渲染选项： PdfRenderingOptions、 XpsRenderingOptions、 DocRenderingOptions 和 ImageRenderingOptions。这些选项允许对输出质量、布局和格式进行精确控制。

PdfDevice

Aspose.HTML for Python via .NET 库中的 Aspose.Html.Rendering.Pdf命名空间提供了将 HTML 和相关格式直接渲染为 PDF 文档的功能。它包括专为 PDF 输出定制的类和参数。主要组件：

• PdfDevice 是基础渲染设备类。它用于将 HTML(或 MHTML、SVG、EPUB 等)转换为 PDF 文件。
• PdfRenderingOptions 是一个定义 PDF 输出自定义设置的类，如页面大小、页边距、图像压缩、元数据、加密和其他布局/格式化选项。

下一个 Python 示例展示了如何使用 PdfDevice 将 HTML 渲染成 PDF。该过程使用默认的渲染选项：

# Render HTML to PDF in Python

import os
import aspose.html as ah
import aspose.html.rendering.pdf as rp

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

input_path = os.path.join(data_dir, "document.html")
output_path = os.path.join(output_dir, "document.pdf")

# Render HTML to PDF
with ah.HTMLDocument(input_path) as document:
    with rp.PdfDevice(output_path) as device:
        document.render_to(device)

渲染选项可以让你对渲染过程进行额外的控制。如需了解更多信息，请阅读 渲染选项 一文。

图像设备

Aspose.Html.Rendering.Image 命名空间提供了一个特定的 ImageDevice类以及 ImageRenderingOptions 类，负责将 HTML 文件渲染为光栅格式：JPG、PNG、BMP、GIF 和 TIFF。

本示例演示了如何使用 Aspose.HTML for Python 通过 .NET 将 HTML 文件转换为 JPEG 图像。代码从磁盘加载 HTML 文档，为 JPEG 格式配置 ImageRenderingOptions，然后使用 ImageDevice 将文档渲染为输出图像文件。

# Render HTML to JPG in Python

import os
import aspose.html as ah
import aspose.html.rendering.image as ri

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(data_dir, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.jpg")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure JPG output
    options = ri.ImageRenderingOptions(ri.ImageFormat.JPEG)

    # Render HTML to JPG
    with ri.ImageDevice(options, save_path) as device:
        document.render_to(device)

XpsDevice

Aspose.Html.Rendering.Xps 名称空间提供了 XpsDevice 类，用于将 HTML 内容(或 MHTML、SVG、EPUB 等)渲染为 XPS 文档。下面的 Python 示例使用默认渲染选项演示了这一过程：

# Render HTML to XPS in Python

import os
import aspose.html as ah
import aspose.html.rendering.xps as rx

# Prepare input and output paths
data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(data_dir, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.xps")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    # Configure XPS output
    options = rx.XpsRenderingOptions()

    # Render HTML to XPS
    with rx.XpsDevice(options, save_path) as device:
        document.render_to(device)

DocDevice

Aspose.Html.Rendering.Doc 名称空间包含 DocDevice 类，该类可将 HTML、MHTML、SVG 和 EPUB 文件渲染为 DOCX 格式。下面的 Python 示例使用默认呈现选项演示了这一过程：

# Render HTML to DOCX in Python

import os
import aspose.html as ah
import aspose.html.rendering.doc as rd

# Prepare the output path
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)
save_path = os.path.join(output_dir, "document.docx")

# Render the webpage to DOCX
with ah.HTMLDocument("https://docs.aspose.com/html/files/document.html") as document:
    with rd.DocDevice(save_path) as device:
        document.render_to(device)

Aspose.HTML 提供免费的在线 转换器，可将 HTML、XHTML、MHTML、EPUB、XML 和 Markdown 文件转换为一系列流行格式。你可以轻松地将基于 HTML 的文档转换为 PDF、XPS、DOCX、JPG、PNG、GIF、TIFF 等格式。只需选择文件，选择要转换的格式，就大功告成了。最重要的是，它完全免费！