Сохранить HTML-документа на Python

Как сохранить HTML на Python

В этой статье представлено подробное руководство о том, как сохранить HTML-документ с помощью Aspose.HTML for Python via .NET API. После работы с HTML-документами вы можете сохранить изменения одним из методов HTMLDocument.save(). Существуют способы сохранить документ в файл или URL-адрес.

• Aspose.HTML Python API предоставляет пространство имен aspose.html.saving с классами SaveOptions и ResourceHandlingOptions, которые позволяют вам устанавливать параметры для операций сохранения.
• Aspose.HTML for Python via .NET предоставляет пространство имен aspose.html.saving.resourcehandlers, которое содержит классы ResourceHandler и FileSystemResourceHandler, отвечающие за обработку ресурсов.

В этой статье будет рассмотрено использование классов SaveOptions и ResourceHandler.

Сохранить HTML

После внесения изменений в HTML-документ вы можете сохранить его. Вы можете сделать это, используя один из методов save(), предоставляемых классом HTMLDocument. Вот простой пример Python для сохранения 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)

В приведенном выше примере мы используем конструктор HTMLDocument() для инициализации пустого HTML-документа. Метод create_text_node(data) класса HTMLDocument создает текстовый узел по заданной строке. Когда вы вызываете document.save(document_path), метод записывает HTML-содержимое объекта document в файл, указанный document_path.

Приведенный выше пример довольно прост. Однако в реальных приложениях часто требуется дополнительный контроль над процессом сохранения. В следующих нескольких разделах описывается, как использовать параметры обработки ресурсов или сохранять документ в различных форматах.

SaveOptions и ResourceHandlingOptions

SaveOptions – это базовый класс, который позволяет указывать дополнительные параметры сохранения операций и помогает управлять связанными ресурсами. Свойство resource_handling_options класса SaveOptions используется для настройки обработки ресурсов. Класс ResourceHandlingOptions определяет параметры управления ресурсами, связанными с HTML-документом. Он предоставляет несколько свойств для управления тем, как обрабатываются различные типы ресурсов во время сохранения или обработки документа:

• Свойство java_script определяет способ управления ресурсами JavaScript. Его можно сохранить как отдельный связанный файл, встроить в HTML-файл или даже игнорировать. Значение по умолчанию – ResourceHandling.SAVE.

• Свойство default устанавливает метод обработки по умолчанию для всех ресурсов. Значение по умолчанию – ResourceHandling.SAVE.

• Свойство resource_url_restriction определяет ограничения URL-адресов для таких ресурсов, как CSS, JavaScript и изображения. Значением по умолчанию является UrlRestriction.SAME_HOST, которое ограничивает ресурсы только теми, которые размещены в том же домене, что и документ.

• Свойство page_url_restriction определяет ограничения URL-адресов для страниц. Значение по умолчанию – UrlRestriction.ROOT_AND_SUB_FOLDERS, что означает, что будут обрабатываться только страницы в корневом каталоге и его подпапках.

• Свойство max_handling_length контролирует максимальную глубину обработки страницы. Глубина 1 означает, что будут обрабатываться только страницы, на которые есть прямые ссылки из сохраненного документа. Если для этого свойства установлено значение -1, будут обрабатываться все страницы. Значение по умолчанию – 0, что означает, что будет обрабатываться только сам документ.

Сохранить HTML в файл

В следующем фрагменте кода Python показано, как использовать свойство resource_handling_options класса SaveOptions для управления связанными с вашими файлами документа.

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

Если вам нужно сохранить HTML как изображение или документ с фиксированным макетом, например PDF, вы можете преобразовать документ в нужный вам формат. Дополнительную информацию см. в разделе Конвертер HTML.

Сохранить HTML в MHTML

В некоторых случаях вам необходимо сохранить веб-страницу в виде одного файла. Документ MHTML может быть удобен и полезен для этой цели, поскольку он представляет собой архив веб-страницы и хранит все внутри себя. HTMLSaveFormat Enumeration определяет формат, в котором сохраняется документ. Это могут быть форматы HTML, MHTML и Markdown. В приведенном ниже примере показано, как использовать метод save(path, save_format) для сохранения HTML в 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)

Сохраненный файл save-to-MTHML.mht хранит HTML файлы document.html и linked-file.html.

Сохранить HTML в Markdown

Markdown – это язык разметки с синтаксисом простого текста. Помимо примера HTML в MHTML, вы можете использовать HTMLSaveFormat для сохранения HTML в Markdown. Пожалуйста, взгляните на следующий пример 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)

Сохранить SVG

Обычно SVG встроен в файл HTML для представления векторной графики, такой как изображения, значки, таблицы и т. д. Однако SVG также можно извлечь из веб-страницы и манипулировать им независимо, как и HTML-документ.

Поскольку и SVGDocument, и HTMLDocument соответствуют стандарту WHATWG DOM, их операции, такие как загрузка, чтение, редактирование, преобразование и сохранение, во многом схожи. Таким образом, любые примеры, демонстрирующие манипуляции с HTMLDocument, также могут быть применены к 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)

Для получения дополнительной информации об использовании Python API Aspose.SVG для обработки и рендеринга документов SVG обратитесь к документации Aspose.SVG for Python via .NET.

Загрузите библиотеку Aspose.HTML for Python via .NET, чтобы успешно, быстро и легко манипулировать вашими HTML-документами. Библиотека Python может создавать, изменять, извлекать данные, конвертировать и отображать HTML-документы без необходимости использования внешнего программного обеспечения. Она поддерживает популярные форматы файлов, такие как EPUB, MHTML, XML, SVG и Markdown, а также может выполнять рендеринг в форматах файлов PDF, DOCX, XPS и изображений.

Aspose.HTML предлагает бесплатный онлайн Kонвертер HTML для преобразования HTML-документов в различные популярные форматы. Просто загрузите HTML из файла или URL-адреса, выберите формат для преобразования, и все готово. Это быстро и совершенно бесплатно!