HTML-Dokument in Python speichern

Wie man HTML in Python speichert

Dieser Artikel bietet eine detaillierte Anleitung zum Speichern eines HTML-Dokuments mit Aspose.HTML for Python via .NET API. Nachdem Sie mit HTML-Dokumenten gearbeitet haben, können Sie die Änderungen mit einer der Methoden HTMLDocument.save() speichern. Es gibt Methoden, um ein Dokument in einer Datei oder URL zu speichern.

• Aspose.HTML Python API bietet den aspose.html.saving Namespace mit den Klassen SaveOptions und ResourceHandlingOptions, mit denen Sie Optionen für Speichervorgänge festlegen können.
• Aspose.HTML for Python via .NET bietet den Namensraum aspose.html.saving.resourcehandlers, der die Klassen ResourceHandler und FileSystemResourceHandler enthält, die für die Handhabung von Ressourcen zuständig sind.

Bitte beachten Sie, dass Aspose.HTML for Python via .NET zwei verschiedene Ansätze für die Erstellung der Ausgabedateien bietet:

1. HTML-basierter Ansatz: Bei dieser Methode werden HTML-ähnliche Dateien als Ausgabe erzeugt. Es wird die Klasse SaveOptions verwendet, die als Grundlage für die Verwaltung des Speichervorgangs von zugehörigen Ressourcen wie Skripten, Stilen und Bildern dient. Die Klasse ResourceHandler ist für die Handhabung dieser Ressourcen zuständig. Sie wurde entwickelt, um HTML-Inhalte und zugehörige Ressourcen in Streams zu speichern, und bietet Methoden, mit denen Sie steuern können, was mit der Ressource geschehen soll.

2. Visueller Darstellungsansatz: Diese Methode konzentriert sich auf die Erstellung einer visuellen Darstellung von HTML. Er basiert auf der Klasse RenderingOptions, die spezielle Methoden zur Definition von Seitengröße, Rändern, Auflösung, Benutzerstilen und mehr bietet.

Dieser Artikel behandelt die Verwendung der Klassen SaveOptions und ResourceHandler.

HTML speichern

Wenn Sie Ihre Änderungen an Ihrem HTML-Dokument abgeschlossen haben, möchten Sie es vielleicht speichern. Dies können Sie mit einer der Methoden save() tun, die von der Klasse HTMLDocument bereitgestellt werden. Hier ist ein einfaches Python-Beispiel zum Speichern einer HTML-Datei:

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

Im obigen Beispiel verwenden wir den Konstruktor HTMLDocument(), um ein leeres HTML-Dokument zu initialisieren. Die Methode create_text_node(data) der Klasse HTMLDocument erzeugt einen Textknoten mit der angegebenen Zeichenkette. Wenn Sie document.save(document_path) aufrufen, schreibt die Methode den HTML-Inhalt des document-Objekts in die durch document_path angegebene Datei.

Das obige Beispiel ist recht einfach. In realen Anwendungen benötigen Sie jedoch oft zusätzliche Kontrolle über den Speichervorgang. In den nächsten Abschnitten wird beschrieben, wie Sie die Optionen für die Ressourcenbehandlung nutzen oder Ihr Dokument in den verschiedenen Formaten speichern können.

SaveOptions und ResourceHandlingOptions

Die Klasse SaveOptions ist eine Basisklasse, die es Ihnen ermöglicht, zusätzliche Optionen für Speichervorgänge anzugeben und die Verwaltung der verknüpften Ressourcen zu erleichtern. Die Eigenschaft resource_handling_options der Klasse SaveOptions dient der Konfiguration der Ressourcenverwaltung. Die Klasse ResourceHandlingOptions definiert Optionen für die Verwaltung von Ressourcen, die mit einem HTML-Dokument verbunden sind. Sie bietet mehrere Eigenschaften, um zu steuern, wie verschiedene Arten von Ressourcen während des Speicherns oder der Verarbeitung des Dokuments behandelt werden:

• die Eigenschaft java_script bestimmt, wie JavaScript-Ressourcen verwaltet werden. Sie können als separate verknüpfte Datei gespeichert, in eine HTML-Datei eingebettet oder auch ignoriert werden. Der Standardwert ist ResourceHandling.SAVE.

• default legt die Standardbehandlungsmethode für alle Ressourcen fest. Der Standardwert ist ResourceHandling.SAVE.

• die Eigenschaft resource_url_restriction definiert die URL-Einschränkungen für Ressourcen wie CSS, JavaScript und Bilder. Der Standardwert ist UrlRestriction.SAME_HOST, der die Ressourcen auf diejenigen beschränkt, die in der gleichen Domäne wie das Dokument gehostet werden.

• die Eigenschaft page_url_restriction legt URL-Einschränkungen für Seiten fest. Der Standardwert ist UrlRestriction.ROOT_AND_SUB_FOLDERS, was bedeutet, dass nur Seiten innerhalb des Stammverzeichnisses und seiner Unterordner behandelt werden.

• die Eigenschaft max_handling_depth steuert die maximale Tiefe der Seitenbehandlung. Eine Tiefe von 1 bedeutet, dass nur Seiten behandelt werden, auf die im gespeicherten Dokument direkt verwiesen wird. Wird diese Eigenschaft auf -1 gesetzt, werden alle Seiten behandelt. Der Standardwert ist 0, was bedeutet, dass nur das Dokument selbst verarbeitet wird.

HTML in einer Datei speichern

Der folgende Python-Codeausschnitt zeigt, wie die Eigenschaft resource_handling_options der Klasse SaveOptions verwendet werden kann, um die Verknüpfung mit Ihren Dokumentdateien zu verwalten.

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

Wenn Sie HTML als Bild oder als Dokument mit einem festen Layout wie PDF speichern möchten, können Sie das Dokument in das gewünschte Format konvertieren. Weitere Informationen finden Sie im Abschnitt HTML-Konverter.

HTML in MHTML speichern

In manchen Fällen müssen Sie Ihre Webseite als eine einzige Datei speichern. das Dokument MHTML könnte für diesen Zweck praktisch und hilfreich sein, da es ein Webseitenarchiv ist und alles in sich selbst speichert. Die HTMLSaveFormat Enumeration gibt das Format an, in dem das Dokument gespeichert wird, es können HTML-, MHTML- und Markdown-Formate sein. Das folgende Beispiel zeigt, wie die Methode save(path, save_format) zum Speichern von HTML in MHTML verwendet wird.

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

In der Datei “save-to-MTHML.mht” wird der HTML-Code der Dateien “document.html” und “linked-file.html” gespeichert.

HTML in Markdown speichern

Markdown ist eine Auszeichnungssprache mit Klartext-Syntax. Genauso wie für das HTML zu MHTML Beispiel, können Sie das HTMLSaveFormat für das Speichern von HTML zu Markdown verwenden. Bitte sehen Sie sich das folgende Python-Beispiel an:

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

SVG speichern

In der Regel wird SVG in eine HTML-Datei eingebettet, um Vektorgrafiken wie Bilder, Symbole, Tabellen und andere darzustellen. SVG kann jedoch auch aus einer Webseite extrahiert und unabhängig bearbeitet werden, ähnlich wie ein HTML-Dokument.

Da sich sowohl SVGDocument als auch HTMLDocument an den WHATWG DOM Standard halten, sind ihre Operationen – wie das Laden, Lesen, Bearbeiten, Konvertieren und Speichern – weitgehend ähnlich. Daher können alle Beispiele, die die Manipulation mit HTMLDocument zeigen, auch auf SVGDocument angewendet werden.

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

Weitere Informationen zur Verwendung der Aspose.SVG Python API für die Verarbeitung und das Rendering von SVG-Dokumenten finden Sie in der Aspose.SVG for Python via .NET Documentation.

Laden Sie die Bibliothek Aspose.HTML for Python via .NET herunter, um Ihre HTML-Dokumente erfolgreich, schnell und einfach zu bearbeiten. Die Python-Bibliothek kann HTML-Dokumente erstellen, ändern, Daten extrahieren, konvertieren und rendern, ohne dass externe Software erforderlich ist. Sie unterstützt gängige Dateiformate wie EPUB, MHTML, XML, SVG und Markdown und kann in die Dateiformate PDF, DOCX, XPS und Image rendern.

Aspose.HTML bietet einen kostenlosen Online- HTML-Konverter zur Konvertierung von HTML-Dokumenten in eine Vielzahl von gängigen Formaten. Laden Sie einfach HTML aus einer Datei oder einer URL, wählen Sie das zu konvertierende Format, und schon sind Sie fertig. Das geht schnell und ist völlig kostenlos!