C# で HTML と Markdown ドキュメントを編集

C# アプリケーション向けドキュメント編集 API

Aspose.HTML for .NET は、HTML と Markdown コンテンツを編集するための構造化 API を提供します。 HTMLDocument を使用して HTML DOM を変更するか、Markdown を型付き構文ツリーとして解析してからノードを更新します。編集後は、ドキュメントを編集可能な形式で保存するか、別のアーカイブまたは変換ワークフローに渡します。

HTML または Markdown の編集ワークフローを選択

• HTML 編集 。 HTML ファイル、URL、文字列、またはストリームを読み込み、DOM 要素を特定し、テキスト、属性、スタイル、ドキュメント構造を変更して、更新済み HTML を保存します。
• Markdown 編集 。 既存の MD ファイルを型付き AST として解析し、見出し、段落、リスト、リンク、その他の構文ノードを更新して、変更したツリーを Markdown に再シリアル化します。
• HTML から MHTML へのワークフロー 。 最初に HTML を編集し、変更したドキュメントと処理対象リソースを MHTML アーカイブとしてパッケージ化します。既存の MHTML または MHT アーカイブはレンダリングや変換の入力であり、編集可能な HTML DOM のソースではありません。

C# で HTML ページのメタデータを更新

この例では、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> の内容、スタイルシート参照を変更します。
• 選択したノード。 CSS セレクター または XPath クエリ で HTML 要素を検索し、型付き AST ノードを使用して Markdown を走査します。
• 出力ワークフロー。 編集可能な HTML または Markdown を保存し、編集済み HTML から MHTML を作成するか、最終結果が PDF、DOCX、XPS、または画像の場合は準備したコンテンツを変換 API に渡します。

ドキュメント編集のドキュメント

Edit HTML Document ガイドでは、DOM ノード、属性、テキスト、マークアップの変更について説明しています。型付き Markdown AST の例については、 Edit and Modify Markdown を参照してください。 Working with HTML Documents セクションでは、読み込み、編集、環境設定、保存、リソース処理について説明しています。

Aspose.HTML for .NET のインストール

.NET CLI を使用して、NuGet から Aspose.HTML for .NET をインストールします。

dotnet add package Aspose.HTML

NuGet パッケージ マネージャーの UI を使用するか、パッケージ マネージャー コンソールで Install-Package Aspose.HTML を実行することもできます。セットアップの詳細は インストール ガイド を参照してください。評価制限なしで API を試すには、 一時ライセンス を申請できます。

HTML、Markdown、MHTML の編集に関する FAQ

1. C# で HTML ファイルを編集するにはどうすればよいですか？

ファイルを HTMLDocument に読み込み、QuerySelector()、GetElementById()、XPath、または DOM の走査で必要な要素を特定します。テキスト、属性、スタイル、子ノードを更新し、Save() を呼び出して編集済み HTML を書き込みます。

2. Markdown は直接編集するべきですか、それとも先に HTML に変換するべきですか？

結果を MD ファイルのまま保持する場合は、MarkdownSyntaxTree を直接編集します。HTML DOM 操作、ブラウザー向けマークアップ、または更新済み Markdown ソースではなくレンダリング出力が必要な場合は、先に Markdown を HTML に変換します。

3. 既存の MHTML ファイルを C# で編集できますか？

既存の MHTML または MHT アーカイブを編集可能な HTMLDocument として読み込むことはできません。元の HTML を編集し、更新済みドキュメントから新しい MHTML アーカイブを作成します。MHTML アーカイブしかない場合は、変換ワークフローを使用します。