Редагування документів 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, використовуйте сценарій конвертації.