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.

# Render HTML to PDF in Python with custom page settings

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

# 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, "document.html")
save_path = os.path.join(output_dir, "render-html-with-options.pdf")

# Load the HTML document
with ah.HTMLDocument(document_path) as document:
    with rn.HtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(600, 200))
        options.encryption = rpe.PdfEncryptionInfo(
            user_password="user_pwd",
            owner_password="owner_pwd",
            permissions=rpe.PdfPermissions.PRINT_DOCUMENT,
            encryption_algorithm=rpe.PdfEncryptionAlgorithm.RC4_128
        )

        # Render HTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            renderer.render(device, document)

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.

# Render SVG to PNG in Python with custom page settings

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

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

doc_path = os.path.join(data_dir, "flower.svg")
save_path = os.path.join(output_dir, "render-svg-with-options.png")

# Load the SVG document
with ah.dom.svg.SVGDocument(doc_path) as document:
    with rn.SvgRenderer() as renderer:
        # Configure PNG output
        options = ri.ImageRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(400, 300))

        # Render SVG to PNG
        with ri.ImageDevice(options, save_path) as device:
            renderer.render(device, document)

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.

# Render MHTML to PDF in Python with custom page settings

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

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

mhtml_path = os.path.join(data_dir, "document.mht")
save_path = os.path.join(output_dir, "render-mhtml-with-options.pdf")

# Open the MHTML file
with open(mhtml_path, "rb") as stream:
    with rn.MhtmlRenderer() as renderer:
        # Configure PDF output
        options = rp.PdfRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))
        options.background_color = pd.Color.bisque

        # Render MHTML to PDF
        with rp.PdfDevice(options, save_path) as device:
            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.

# Render EPUB to DOCX in Python with custom page settings

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

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

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
with open(epub_path, "rb") as stream:
    with rn.EpubRenderer() as renderer:
        # Configure DOCX output
        options = rd.DocRenderingOptions()
        options.page_setup.any_page = dr.Page(dr.Size(800, 400))

        # Render EPUB to DOCX
        with rd.DocDevice(options, save_path) as device:
            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.