Редактирование документов HTML и Markdown на C#

API редактирования документов для приложений C#

Aspose.HTML for .NET предоставляет структурированные API для редактирования содержимого HTML и Markdown. Используйте HTMLDocument , чтобы изменить HTML DOM, или разберите Markdown в типизированное синтаксическое дерево перед обновлением его узлов. После редактирования сохраните документ в редактируемом формате либо передайте его в отдельный сценарий архивирования или конвертации.

Выбор сценария редактирования HTML или Markdown

• Редактирование HTML . Загрузите HTML-файл, URL, строку или поток, найдите элементы DOM, измените текст, атрибуты, стили или структуру документа и сохраните обновленный HTML.
• Редактирование Markdown . Постройте для существующего MD-файла типизированное синтаксическое дерево (AST), обновите заголовки, абзацы, списки, ссылки или другие узлы и сериализуйте измененное дерево обратно в Markdown.
• Сохранение HTML в MHTML . Сначала отредактируйте HTML, затем упакуйте измененный документ и обработанные ресурсы в архив MHTML. Существующие архивы MHTML и MHT служат исходными данными для рендеринга или конвертации, а не редактируемыми источниками HTML DOM.

Обновление метаданных HTML-страницы на C#

Пример загружает HTML-документ, обновляет заголовок страницы и метаописание, при необходимости создает отсутствующие элементы метаданных и сохраняет отредактированный файл. Для Markdown используется отдельный API типизированного синтаксического дерева.

using Aspose.Html;
using Aspose.Html.Dom;

using HTMLDocument document = new HTMLDocument("input.html");

// Update the document title through the HTMLDocument API
document.Title = "Updated page title";

// Find the head and create the description element when it is missing
Element head = document.QuerySelector("head");
if (head != null)
{
    Element description = document.QuerySelector("meta[name='description']");
    if (description == null)
    {
        description = document.CreateElement("meta");
        description.SetAttribute("name", "description");
        head.AppendChild(description);
    }

    description.SetAttribute("content", "Updated page description.");
}

document.Save("edited.html");

Основные шаги редактирования HTML

1. Загрузите исходный документ с помощью конструктора HTMLDocument .
2. Найдите нужный элемент с помощью QuerySelector() , GetElementById(), XPath или другого метода навигации по DOM.
3. Измените текст, атрибуты, стили или дочерние узлы через DOM API.
4. Вызовите Save() , чтобы записать HTML, либо продолжите работу в отдельном сценарии конвертации или создания архива MHTML.

Возможности программного редактирования

• Структура документа. Добавляйте, заменяйте, перемещайте или удаляйте узлы HTML DOM и поддерживаемые синтаксические узлы Markdown.
• Текст и разметка. Изменяйте обычный текст, HTML-разметку, заголовки, абзацы, списки, ссылки, блоки кода и другое структурированное содержимое.
• Атрибуты HTML и CSS. Изменяйте атрибуты элементов, встроенные стили, содержимое <style> и ссылки на таблицы стилей.
• Выбранные узлы. Находите HTML-элементы с помощью CSS-селекторов или XPath-запросов , а структуру Markdown обходите через типизированные узлы AST.
• Выходной сценарий. Сохраняйте редактируемый HTML или Markdown, создавайте MHTML из измененного HTML либо передавайте подготовленное содержимое в API конвертации для получения PDF, DOCX, XPS или изображения.

Документация по редактированию документов

В руководстве Редактирование HTML-документа рассматривается изменение узлов DOM, атрибутов, текста и разметки. Примеры работы с типизированным AST Markdown приведены в статье Редактирование и изменение Markdown . Раздел Работа с HTML-документами объясняет загрузку, редактирование, настройку среды, сохранение и обработку ресурсов.

Установка Aspose.HTML for .NET

Установите Aspose.HTML for .NET из NuGet с помощью .NET CLI:

dotnet add package Aspose.HTML

Также можно использовать интерфейс диспетчера пакетов NuGet или выполнить Install-Package Aspose.HTML в консоли диспетчера пакетов. Подробные инструкции приведены в руководстве по установке . Чтобы протестировать API без ограничений ознакомительной версии, запросите временную лицензию .

Вопросы о редактировании HTML, Markdown и MHTML

1. Как редактировать HTML-файл на C#?

Загрузите файл в HTMLDocument, найдите нужные элементы DOM с помощью QuerySelector(), GetElementById(), XPath или обхода DOM, измените их текст, атрибуты, стили или дочерние узлы и вызовите Save(), чтобы записать отредактированный HTML.

2. Следует ли редактировать Markdown напрямую или сначала преобразовать его в HTML?

Редактируйте MarkdownSyntaxTree напрямую, если результат необходимо сохранить в MD-файле. Сначала преобразуйте Markdown в HTML, если сценарий требует операций с HTML DOM, разметки для отображения в браузере или получения отрендеренного документа вместо обновленного исходного Markdown.

3. Можно ли редактировать существующий MHTML-файл на C#?

Существующий архив MHTML или MHT нельзя загрузить как редактируемый HTMLDocument. Измените исходный HTML и создайте из обновленного документа новый архив MHTML. Если доступен только архив MHTML, используйте сценарий конвертации.