Renderer – Rendern von HTML, MHTML, EPUB und SVG in Python

Renderer

Der aspose.html.rendering Namespace besteht aus zahlreichen Renderer-Objekten und entsprechenden Low-Level-Optionen-Klassen, die für das Rendering von Dokumenten in der IDevice-Implementierung verantwortlich sind. Aspose.HTML für Python via .NET API bietet die folgende Realisierung von Renderern: HtmlRenderer, SvgRenderer, MhtmlRenderer und EpubRenderer, die jeweils zum Rendern von HTML-, SVG-, MHTML- und EPUB-Dokumenten verwendet werden.

Der vorliegende Artikel beschreibt unterstützte Szenarien der HTML-basierten Dateikonvertierung in andere gängige Formate unter Verwendung von render()-Methoden des aspose.html.rendering Namespace.

HtmlRenderer

Die Klasse HtmlRenderer kann zum Rendern von HTML-Dateien in verschiedene gängige Formate verwendet werden und ermöglicht die Anpassung der Rendering-Optionen und die Kontrolle über die Ausgabe des Prozesses. Betrachten wir die Verwendung der Klasse HtmlRenderer zum Rendern von HTML in PDF mit benutzerdefinierten Ausgabeeinstellungen:

1. Initialisieren Sie ein HTML-Dokument mit der Klasse HTMLDocument.
2. Erstellen Sie ein neues HtmlRenderer Objekt.
3. Erstellen Sie eine Instanz von PdfRenderingOptions und passen Sie die Optionen für Ihr PDF-Ausgabedokument an. Sie können zum Beispiel die Eigenschaft any_page der Klasse PageSetup setzen, um ein neues Page-Objekt mit den Abmessungen 600 Pixel mal 200 Pixel zu erstellen. Darüber hinaus können Sie die Eigenschaft encryption konfigurieren, um Benutzer- und Eigentümerpasswörter, zulässige Aktionen und den Verschlüsselungsalgorithmus für die PDF-Ausgabedatei festzulegen.
4. Verwenden Sie den Konstruktor PdfDevice(options, savePath), um ein Objekt der Klasse PdfDevice zu erstellen.
5. Rufen Sie die Methode render(device, document) auf, um HTML in PDF mit den angegebenen Rendering-Optionen zu rendern.

import os
import aspose.html as ah
import aspose.html.rendering as rn
import aspose.html.rendering.pdf as rp
import aspose.html.drawing as dr
import aspose.html.rendering.pdf.encryption as rpe

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

# Prepare path to the source HTML file
document_path = os.path.join(data_dir, "document.html")

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

# Create an instance of the HTML Renderer
renderer = rn.HtmlRenderer()

# Prepare path to save the converted PDF
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Create PDF rendering options and set custom page size
options = rp.PdfRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(600, 200))

# Setup PDF encryption
options.encryption = rpe.PdfEncryptionInfo(
    user_password="user_pwd",
    owner_password="owner_pwd",
    permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
    encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
)

# Create the PDF device with options and output path
device = rp.PdfDevice(options, save_path)

# Render HTML to PDF
renderer.render(device, doc)

Rendering-Optionen geben Ihnen zusätzliche Kontrolle über den Rendering-Prozess. Um mehr über sie zu erfahren, lesen Sie bitte den Artikel Rendering-Optionen.

Weitere Informationen über den Rendering-Prozess finden Sie im Artikel Rendering Device.

SvgRenderer

Mit dem SvgRenderer können Sie SVG-Dateien in andere Dateiformate wie PDF, XPS, DOCX und Bildformate umwandeln. Das folgende Beispiel zeigt, wie die SvgRenderer-Klasse verwendet wird, um SVG in PNG zu rendern, wobei eine benutzerdefinierte Seitengröße angegeben wird:

1. Initialisieren Sie ein SVG-Dokument. Verwenden Sie einen der SVGDocument() Konstruktoren, um eine SVGDocument-Instanz zu erstellen.
2. Erstellen Sie ein neues SvgRenderer-Objekt.
3. Erstellen Sie eine Instanz von ImageRenderingOptions und legen Sie benutzerdefinierte Optionen für das ausgegebene PNG-Bild fest. Im Beispiel geben wir die Eigenschaft any_page an, die ein neues Seitenobjekt mit einer Seitengröße von 400x300 Pixeln festlegt.
4. Verwenden Sie den Konstruktor ImageDevice(options, savePath), um ein Objekt der Klasse ImageDevice zu erstellen.
5. Aufruf der Methode render(device, document) zum Rendern von SVG in PNG mit den angegebenen Rendering-Optionen.

import os
import aspose.html as ah
import aspose.html.rendering.image as ri
import aspose.html.rendering as rn
import aspose.html.drawing as dr

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

# Prepare path to the source SVG file
doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Initialize an SVG document from the file
doc = ah.dom.svg.SVGDocument(doc_path)

# Create an instance of the SVG Renderer
renderer = rn.SvgRenderer()

# Create the instance of Rendering Options and set a custom page-size
options = ri.ImageRenderingOptions()
options.page_setup.any_page = dr.Page(dr.Size(400, 300))

# Create the PNG device with options and output path
device = ri.ImageDevice(options, save_path)

# Render SVG to PNG
renderer.render(device, doc)

MhtmlRenderer

Dieses Beispiel veranschaulicht die Konvertierung eines MHTML-Dokuments in PDF unter Verwendung der Klasse MhtmlRenderer mit bestimmten Rendering-Optionen:

1. Öffnen Sie ein vorhandenes MHTML-Dokument.
2. Erstellen Sie eine Instanz der MhtmlRenderer-Klasse mit dem MhtmlRenderer() Konstruktor.
3. Initialisieren Sie die Klasse PdfRenderingOptions und legen Sie Rendering-Optionen fest.
4. Erstellen Sie eine Instanz der Klasse PdfDevice.
5. Rufen Sie die Methode render(device, stream) auf, um MHTML in PDF umzuwandeln.

import os
import aspose.html.rendering.pdf as rp
import aspose.html.rendering as rn
import aspose.html.drawing as dr
import aspose.pydrawing as pd

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

# Prepare path to the source MHTML file
epub_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file in binary mode
with open("document.mht", 'rb') as stream:

    # Create an instance of MHTML Renderer
    renderer = rn.MhtmlRenderer()

    # Create PDF rendering options and set a custom page size
    options = rp.PdfRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))
    options.background_color = pd.Color.bisque

    # Create an instance of PdfDevice for output
    device = rp.PdfDevice(options, save_path)

    # Render MHTML to PDF
    renderer.render(device, stream)

EpubRenderer

Mit der Klasse EpubRenderer können Sie EPUB-Dateien in andere Formate wie PDF, XPS, DOCX und Bilder konvertieren. Die folgenden Python-Beispiele zeigen, wie EPUB in DOCX mit einer benutzerdefinierten Seitengrößeneinstellung konvertiert werden kann:

1. Öffnen Sie eine vorhandene EPUB-Datei.
2. Erstellen Sie eine Instanz der EpubRenderer-Klasse.
3. Initialisieren Sie die Klasse DocRenderingOptions und legen Sie Rendering-Optionen fest.
4. Erstellen Sie eine Instanz der Klasse DocDevice.
5. Rufen Sie die Methode render(device, stream) auf, um EPUB in DOCX umzuwandeln.

import os
import aspose.html.rendering.doc as rd
import aspose.html.rendering as rn
import aspose.html.drawing as dr

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

# Prepare path to the source EPUB file
epub_path = os.path.join(data_dir, "input.epub")
save_path = os.path.join(output_dir, "render-epub-with-options.docx")

# Open the EPUB file in binary mode
with open(epub_path, "rb") as stream:

    # Create an instance of EPUB Renderer
    renderer = rn.EpubRenderer()

    # Create DOC rendering options and set a custom page size
    options = rd.DocRenderingOptions()
    options.page_setup.any_page = dr.Page(dr.Size(800, 400))

    # Create an instance of DocDevice for output
    device = rd.DocDevice(options, save_path)

    # Render EPUB to DOCX
    renderer.render(device, stream)

Aspose.HTML bietet kostenlose Online- Konverter, die HTML-, XHTML-, MHTML-, EPUB-, XML- und Markdown-Dateien in eine Reihe von gängigen Formaten konvertieren können. Sie können Ihre HTML-basierten Dokumente ganz einfach in PDF, XPS, DOCX, JPG, PNG, GIF, TIFF und andere konvertieren. Wählen Sie einfach eine Datei und das zu konvertierende Format aus, und schon sind Sie fertig.