Renderizadores – Renderiza HTML, MHTML, EPUB y SVG en Python

Renderizadores – Renderers

El espacio de nombres aspose.html.rendering consta de numerosos objetos renderizadores y clases de opciones de bajo nivel apropiadas, que se encargan de renderizar documentos en la implementación IDevice. Aspose.HTML para Python a través de la API .NET proporciona la siguiente realización de renderizadores: HtmlRenderer, SvgRenderer, MhtmlRenderer y EpubRenderer, que se utilizan para renderizar documentos HTML, SVG, MHTML y EPUB, respectivamente.

Este artículo describe los escenarios de conversión de archivos HTML a otros formatos populares utilizando los métodos render() del espacio de nombres aspose.html.rendering.

HtmlRenderer

La clase HtmlRenderer se puede utilizar para renderizar archivos HTML en varios formatos populares, permitiendo la personalización de las opciones de renderizado y el control sobre la salida del proceso. Veamos cómo utilizar la clase HtmlRenderer para convertir HTML a PDF con opciones de salida personalizadas:

1. Inicializa un documento HTML utilizando la clase HTMLDocument.
2. Crea un nuevo objeto HtmlRenderer.
3. Cree una instancia de PdfRenderingOptions y personalice las opciones para su documento PDF de salida. Por ejemplo, puede establecer la propiedad any_page de la clase PageSetup para crear un nuevo objeto Page con unas dimensiones de 600 píxeles por 200 píxeles. Además, puede configurar la propiedad encryption, especificando las contraseñas de usuario y propietario, las acciones permitidas y el algoritmo de cifrado para el archivo PDF de salida.
4. Utilice el constructor PdfDevice(options, savePath) para crear un objeto de la clase PdfDevice.
5. Llama al método render(device, document) para renderizar HTML a PDF con las opciones de renderizado especificadas.

# Render HTML to PDF with custom page settings using Python

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)

Las opciones de renderizado te dan un control adicional sobre el proceso de renderizado. Para saber más sobre ellas, lee el artículo Opciones de renderizado.

Para obtener más información sobre el proceso de renderizado, consulte el artículo Dispositivo de renderizado.

SvgRenderer

La clase SvgRenderer permite convertir archivos SVG a otros formatos de archivo, como PDF, XPS, DOCX y formatos de imagen. El siguiente ejemplo muestra cómo utilizar la clase SvgRenderer para convertir SVG a PNG especificando un tamaño de página personalizado:

1. Inicializar un documento SVG. Utilice uno de los constructores SVGDocument() para crear una instancia de SVGDocument.
2. Crea un nuevo objeto SvgRenderer.
3. Cree una instancia de ImageRenderingOptions y establezca opciones personalizadas para la imagen PNG de salida. En el ejemplo, especificamos la propiedad any_page que establece un nuevo objeto Page con un tamaño de página de 400x300 píxeles.
4. Utilice el constructor ImageDevice(options, savePath) para crear un objeto de la clase ImageDevice.
5. Llama al método render(device, document) para renderizar SVG a PNG con las opciones de renderizado especificadas.

# Render SVG to PNG with custom page settings using Python

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

Este ejemplo ilustra cómo convertir un documento MHTML a PDF utilizando la clase MhtmlRenderer con las opciones de renderizado especificadas:

1. Abra un documento MHTML existente.
2. Crea una instancia de la clase MhtmlRenderer usando el constructor MhtmlRenderer().
3. Inicializa la clase PdfRenderingOptions y establece las opciones de renderizado.
4. Crear una instancia de la clase PdfDevice.
5. Llama al método render(device, stream) para renderizar MHTML a PDF.

# Render MHTML to PDF with custom page settings using Python

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 and background color
    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 clase EpubRenderer permite convertir archivos EPUB a otros formatos como PDF, XPS, DOCX e imágenes. Los siguientes ejemplos de Python muestran cómo convertir EPUB a DOCX con una configuración de tamaño de página personalizada:

1. Abrir un archivo EPUB existente.
2. Crea una instancia de la clase EpubRenderer.
3. Inicializa la clase DocRenderingOptions y establece las opciones de renderizado.
4. Crear una instancia de la clase DocDevice.
5. Llama al método render(device, stream) para renderizar EPUB a DOCX.

# Render EPUB to DOCX with custom page settings using Python

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 ofrece Convertidores en línea gratuitos que pueden convertir archivos HTML, XHTML, MHTML, EPUB, XML y Markdown a una serie de formatos populares. Puedes convertir fácilmente tus documentos basados en HTML a PDF, XPS, DOCX, JPG, PNG, GIF, TIFF y otros. Sólo tienes que seleccionar un archivo, elegir el formato a convertir y listo.