Renderers – Rendre HTML, MHTML, EPUB et SVG en Python

Renderers

L’espace de noms aspose.html.rendering comprend de nombreux objets de rendu et des classes d’options de bas niveau appropriées, qui sont responsables du rendu des documents dans l’implémentation IDevice. Aspose.HTML for Python via .NET API fournit la réalisation suivante d’objets de rendu : HtmlRenderer, SvgRenderer, MhtmlRenderer, et EpubRenderer, qui sont utilisés pour rendre les documents HTML, SVG, MHTML, et EPUB, respectivement.

Cet article décrit des scénarios de conversion de fichiers HTML vers d’autres formats populaires à l’aide des méthodes render() de l’espace de noms aspose.html.rendering.

HtmlRenderer

La classe HtmlRenderer peut être utilisée pour rendre des fichiers HTML dans divers formats populaires, permettant de personnaliser les options de rendu et de contrôler le résultat du processus. Voyons comment utiliser la classe HtmlRenderer pour rendre HTML en PDF avec des paramètres de sortie personnalisés :

1. Initialiser un document HTML en utilisant la classe HTMLDocument.
2. Créer un nouvel objet HtmlRenderer.
3. Créez une instance de la classe PdfRenderingOptions et personnalisez les options de votre document PDF de sortie. Par exemple, vous pouvez définir la propriété any_page de la classe PageSetup pour créer un nouvel objet Page avec des dimensions de 600 pixels par 200 pixels. En outre, vous pouvez configurer la propriété encryption, en spécifiant les mots de passe de l’utilisateur et du propriétaire, les actions autorisées et l’algorithme de cryptage pour le fichier PDF de sortie.
4. Utilisez le constructeur PdfDevice(options, savePath) pour créer un objet de la classe PdfDevice.
5. Appeler la méthode render(device, document) pour rendre HTML en PDF avec les options de rendu spécifiées.

# 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)

Les options de rendu vous donnent un contrôle supplémentaire sur le processus de rendu. Pour en savoir plus, lisez l’article Options de rendu.

Pour en savoir plus sur le processus de rendu, voir l’article Dispositif de rendu.

SvgRenderer

La classe SvgRenderer vous permet de convertir des fichiers SVG en d’autres formats de fichiers, tels que PDF, XPS, DOCX et des formats d’images. L’exemple suivant montre comment utiliser la classe SvgRenderer pour convertir un fichier SVG en PNG en spécifiant une taille de page personnalisée :

1. Initialiser un document SVG. Utilisez l’un des constructeurs SVGDocument() pour créer une instance de SVGDocument.
2. Créer un nouvel objet SvgRenderer.
3. Créez une instance de ImageRenderingOptions et définissez des options personnalisées pour l’image PNG de sortie. Dans l’exemple, nous spécifions la propriété any_page qui définit un nouvel objet Page avec une taille de page de 400x300 pixels.
4. Utilisez le constructeur ImageDevice(options, savePath) pour créer un objet de la classe ImageDevice.
5. Appeler la méthode render(device, document) pour rendre SVG en PNG avec les options de rendu spécifiées.

# 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

Cet exemple illustre comment convertir un document MHTML en PDF en utilisant la classe MhtmlRenderer avec les options de rendu spécifiées :

1. Ouvrir un document MHTML existant.
2. Créez une instance de la classe MhtmlRenderer en utilisant le constructeur MhtmlRenderer().
3. Initialiser la classe PdfRenderingOptions et définir les options de rendu.
4. Créer une instance de la classe PdfDevice.
5. Appelez la méthode render(device, stream) pour convertir le MHTML en PDF.

# 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

La classe EpubRenderer vous permet de convertir des fichiers EPUB en d’autres formats tels que PDF, XPS, DOCX et images. L’exemple Python suivant montre comment convertir un fichier EPUB en DOCX avec un paramètre de taille de page personnalisé :

1. Ouvrir un fichier EPUB existant.
2. Créer une instance de la classe EpubRenderer.
3. Initialiser la classe DocRenderingOptions et définir les options de rendu.
4. Créer une instance de la classe DocDevice.
5. Appeler la méthode render(device, stream) pour convertir l’EPUB en DOCX.

# 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 propose des Convertisseurs gratuits en ligne qui permettent de convertir des fichiers HTML, XHTML, MHTML, EPUB, XML et Markdown dans toute une série de formats populaires. Vous pouvez facilement convertir vos documents HTML en PDF, XPS, DOCX, JPG, PNG, GIF, TIFF et autres. Il vous suffit de sélectionner un fichier, de choisir le format à convertir et le tour est joué.