渲染设备 – 将 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 using Python

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

# Prepare output directory and path for the PDF file
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)
save_path = os.path.join(output_dir, "document.pdf")

# Prepare HTML code
code = "<span>Hello, World!!</span>"

# Initialize an HTML document from the HTML code
doc = ah.HTMLDocument(code, ".")

# Create a PDF Device and specify the output file to render
device = rp.PdfDevice(save_path)

# Render HTML to PDF
doc.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 using Python

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

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

# Prepare paths for input HTML and output JPG file
document_path = os.path.join(data_dir, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.jpg")

# Initialize an HTML document from the file
doc = ah.HTMLDocument(document_path)

# Create rendering options for image format (JPEG in this case)
image_options = ri.ImageRenderingOptions(ri.ImageFormat.JPEG)

# Create an ImageDevice and specify options and output file
device = ri.ImageDevice(image_options, save_path)

# Render HTML to JPG
doc.render_to(device)

XpsDevice

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

# Render HTML to XPS using Python

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

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

# Prepare paths for input HTML and output XPS file
document_path = os.path.join(data_dir, "drawing.html")
save_path = os.path.join(output_dir, "drawing-output.xps")

# Initialize an HTML document from the file
doc = ah.HTMLDocument(document_path)

# Create rendering options for XPS format
xps_options = rx.XpsRenderingOptions()

# Create an XpsDevice and specify options and output file
device = rx.XpsDevice(xps_options, save_path)

# Render HTML to XPS
doc.render_to(device)

DocDevice

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

# Render HTML to DOCX using Python

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

# Prepare output directory and path for the DOCX file
output_dir = "output/"
os.makedirs(output_dir, exist_ok=True)
save_path = os.path.join(output_dir, "document.doc")

# Initialize an HTML document from URL
doc = ah.HTMLDocument("https://docs.aspose.com/html/files/document.html")

# Create a DocDevice and specify the output file to render
device = rd.DocDevice(save_path)

# Render HTML to DOCX
doc.render_to(device)

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