Guardar documento HTML en Python

Cómo guardar HTML en Python

Este artículo ofrece una guía detallada sobre cómo guardar un documento HTML usando Aspose.HTML for Python via .NET API. Después de trabajar con documentos HTML, puede guardar los cambios utilizando uno de los métodos HTMLDocument.save(). Existen métodos para guardar un documento en un archivo o URL.

• Aspose.HTML Python API proporciona aspose.html.saving espacio de nombres con las clases SaveOptions y ResourceHandlingOptions que le permiten configurar opciones para guardar operaciones.
• Aspose.HTML for Python via .NET proporciona aspose.html.saving.resourcehandlers espacio de nombres que contiene las clases ResourceHandler y FileSystemResourceHandler responsables de manejar los recursos.

Tenga en cuenta que Aspose.HTML for Python via .NET ofrece dos enfoques diferentes para crear los archivos de salida:

1. Enfoque basado en HTML: esta forma implica producir archivos similares a HTML como salida. Utiliza la clase SaveOptions, que sirve como base para gestionar el proceso de guardado de recursos relacionados, como scripts, estilos e imágenes. La clase ResourceHandler es responsable de manejar estos recursos. Está desarrollado para guardar contenido HTML y recursos asociados en secuencias y proporciona métodos que le permiten controlar lo que se hará con el recurso.

2. Enfoque de representación visual: este método se centra en crear una representación visual de HTML. Se basa en la clase RenderingOptions, que ofrece métodos especializados para definir el tamaño de página, márgenes, resolución, estilos de usuario y más.

Este artículo cubrirá el uso de las clases SaveOptions y ResourceHandler.

Guardar HTML

Una vez que haya completado los cambios en su documento HTML, es posible que desee guardarlo. Puede hacer esto usando uno de los métodos save() proporcionados por la clase HTMLDocument. Aquí hay un ejemplo simple de Python para guardar un archivo HTML:

# Save HTML to a file in Python

import os
import aspose.html as ah

# Prepare the output path
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(output_dir, "save-html-document.html")

# Create an empty HTML document
with ah.HTMLDocument() as document:
    # Create a text node and add it to the document
    text = document.create_text_node("Hello, World!")
    document.body.append_child(text)

    # Save the HTML document
    document.save(document_path)

En el ejemplo anterior, utilizamos el constructor HTMLDocument() para inicializar un documento HTML vacío. El método create_text_node(data) de la clase HTMLDocument crea un nodo de texto dada la cadena especificada. Cuando llamas a document.save(document_path), el método escribe el contenido HTML del objeto document en el archivo especificado por document_path.

El ejemplo anterior es bastante simple. Sin embargo, en aplicaciones de la vida real, a menudo se necesita control adicional sobre el proceso de guardado. Las siguientes secciones describen cómo utilizar las opciones de manejo de recursos o guardar su documento en diferentes formatos.

SaveOptions y ResourceHandlingOptions

SaveOptions es una clase base que le permite especificar opciones adicionales para guardar operaciones y ayuda a administrar los recursos vinculados. La propiedad resource_handling_options de la clase SaveOptions se utiliza para la configuración del manejo de recursos. La clase ResourceHandlingOptions define opciones para administrar los recursos asociados con un documento HTML. Proporciona varias propiedades para controlar cómo se manejan los distintos tipos de recursos durante el guardado o procesamiento del documento:

• La propiedad java_script determina cómo se administran los recursos de JavaScript. Podría guardarse como un archivo vinculado separado, incrustarse en un archivo HTML o incluso ignorarse. El valor predeterminado es ResourceHandling.SAVE.

• La propiedad default establece el método de manejo predeterminado para todos los recursos. El valor predeterminado es ResourceHandling.SAVE.

• La propiedad resource_url_restriction define las restricciones de URL para recursos como CSS, JavaScript e imágenes. El valor predeterminado es UrlRestriction.SAME_HOST, que restringe los recursos a aquellos alojados en el mismo dominio que el documento.

• La propiedad page_url_restriction especifica restricciones de URL para las páginas. El valor predeterminado es UrlRestriction.ROOT_AND_SUB_FOLDERS, lo que significa que solo se manejarán las páginas dentro del directorio raíz y sus subcarpetas.

• La propiedad max_handling_depth controla la profundidad máxima de manejo de la página. Una profundidad de 1 significa que solo se manejarán las páginas a las que se hace referencia directamente desde el documento guardado. Establecer esta propiedad en -1 manejará todas las páginas. El valor predeterminado es 0, lo que significa que sólo se procesará el documento en sí.

Guardar HTML en un archivo

El siguiente fragmento de código de Python muestra cómo utilizar la propiedad resource_handling_options de la clase SaveOptions para administrar los archivos vinculados a sus documentos.

# Save HTML with linked resources in Python

import os
import aspose.html as ah
import aspose.html.saving as sav

# Prepare output paths
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

document_path = os.path.join(output_dir, "save-with-linked-file.html")

# Create an HTML file with a linked page
with open(document_path, "w", encoding="utf-8") as file:
    file.write("<p>Hello, World!</p><a href='linked.html'>linked file</a>")

# Create the linked HTML file
with open(os.path.join(output_dir, "linked.html"), "w", encoding="utf-8") as file:
    file.write("<p>Hello, linked file!</p>")

# Load and save the HTML document with directly linked pages
output_path = os.path.join(output_dir, "save-with-linked-file_out.html")
with ah.HTMLDocument(document_path) as document:
    options = sav.HTMLSaveOptions()
    options.resource_handling_options.max_handling_depth = 1
    document.save(output_path, options)

Si necesita guardar HTML como una imagen o un documento con un diseño fijo como PDF, puede convertir el documento al formato que necesite. Consulte la sección Convertidor HTML para obtener más información.

Guardar HTML en MHTML

En algunos casos, deberá guardar su página web como un solo archivo. El documento MHTML puede resultar útil y útil para este propósito, ya que es un archivo de página web y almacena todo dentro de sí mismo. La Enumeración HTMLSaveFormat especifica el formato en el que se guarda el documento; puede ser formato HTML, MHTML y Markdown. El siguiente ejemplo muestra cómo utilizar el método save(path, save_format) para guardar HTML en MHTML.

# Save HTML as MHTML in Python

import os
import aspose.html as ah
import aspose.html.saving as sav

# Prepare the output path
output_dir = "output"
document_path = os.path.join(output_dir, "save-html-to-mhtml.mht")
os.makedirs(output_dir, exist_ok=True)

# Create an HTML file with a linked page
with open("document.html", "w", encoding="utf-8") as file:
    file.write("<p>Hello, World!</p><a href='linked-file.html'>linked file</a>")

# Create the linked HTML file
with open("linked-file.html", "w", encoding="utf-8") as file:
    file.write("<p>Hello, linked file!</p>")

# Load HTML and save it as MHTML
with ah.HTMLDocument("document.html") as document:
    document.save(document_path, sav.HTMLSaveFormat.MHTML)

El archivo “save-to-MTHML.mht” guardado almacena HTML de los archivos “document.html” y “linked-file.html”.

Guardar HTML en Markdown

Markdown es un lenguaje de marcado con sintaxis de texto sin formato. Además del ejemplo de HTML a MHTML, puede utilizar HTMLSaveFormat para guardar HTML en Markdown. Eche un vistazo al siguiente ejemplo de Python:

# Save HTML as Markdown in Python

import os
import aspose.html as ah
import aspose.html.saving as sav

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

input_path = os.path.join(data_dir, "document.html")
output_path = os.path.join(output_dir, "html-to-markdown.md")

# Load HTML and save it as Markdown
with ah.HTMLDocument(input_path) as document:
    document.save(output_path, sav.HTMLSaveFormat.MARKDOWN)

Guardar SVG

Por lo general, SVG está incrustado en un archivo HTML para representar gráficos vectoriales como imágenes, iconos, tablas y más. Sin embargo, SVG también se puede extraer de una página web y manipular de forma independiente, de forma muy parecida a un documento HTML.

Dado que tanto SVGDocument como HTMLDocument se adhieren al estándar WHATWG DOM, sus operaciones (como cargar, leer, editar, convertir y guardar) son en gran medida similares. Por lo tanto, cualquier ejemplo que demuestre la manipulación con HTMLDocument también se puede aplicar a SVGDocument.

# Create and save an SVG file in Python

import os
import aspose.html.dom.svg as ahsvg

# Prepare the output path
output_dir = "output"
document_path = os.path.join(output_dir, "save-html-to-svg.svg")
os.makedirs(output_dir, exist_ok=True)

# Prepare SVG code
svg_code = """
<svg xmlns='http://www.w3.org/2000/svg' height='400' width='300'>
    <path stroke="#a06e84" stroke-width="3" fill="#74aeaf" d="  
	M 150,50 L 150, 300
	M 120,100 L 150,50 L 180, 100
    M 110,150 L 150,90 L 190, 150
	M 90,220 L 150,130 L 210, 220
	M 70,300 L 150,190 L 230, 300
    M 110,310 L 150,240 L 190, 310
	" />
</svg>
"""

# Create and save the SVG document
with ahsvg.SVGDocument(svg_code, ".") as document:
    document.save(document_path)

Para obtener más información sobre el uso de la API de Python de Aspose.SVG para el procesamiento y representación de documentos SVG, consulte la Documentación de Aspose.SVG for Python via .NET.

Descargue la biblioteca Aspose.HTML for Python via .NET para manipular con éxito, rapidez y facilidad sus documentos HTML. La biblioteca Python puede crear, modificar, extraer datos, convertir y renderizar documentos HTML sin necesidad de software externo. Admite formatos de archivos populares como EPUB, MHTML, XML, SVG y Markdown y puede renderizar en formatos de archivos PDF, DOCX, XPS e imágenes.

Aspose.HTML ofrece un Convertidor HTML en línea gratuito para convertir documentos HTML a una variedad de formatos populares. Simplemente cargue HTML desde un archivo o URL, elija el formato a convertir y listo. ¡Es rápido y completamente gratis!