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.

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)

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.

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

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.

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

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.

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 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é.