docfx C#（開発者向けの使用方法）

イントロダクション

今日のソフトウェア開発環境では、プロジェクトの成功を保証するために、明確で徹底した文書化が極めて重要です。 DocFx C#とIronPDFは、ドキュメントを生成し、ドキュメントのワークフローを合理化しながら、プロジェクトドキュメントの読みやすさとアクセシビリティを向上させる2つの効果的なツールです。 この投稿では、C#ライブラリであるIronPDFを使用してPDFドキュメントを作成し、APIリファレンスドキュメントを生成するAPIドキュメントジェネレーターであるDocFXと組み合わせる方法を説明します。 開発者はこれらのツールを使用することで、迅速に優れたドキュメントを作成し、PDF形式で共有することができます。

DocFXの使用方法

1. .NET SDK 6.0以上をインストール

2. PowerShellを開きます。

3. スクリプトを一つずつ実行し、DocFXライブラリをインストールしてください。

4. インストール後、JSONファイルを実行してください。

5. 8080ポートでドキュメンテーションサイトを開きます。

DocFXの紹介

Microsoftはオープンソースの静的サイトジェネレーターおよびドキュメント生成ツールのDocFXを作成しました。 Markdownファイルとソースコードを使用することで、開発者はプロフェッショナルな外観のドキュメントウェブサイトを作成できます。 DocFX は、多数のマークアップ形式とプログラミング言語をサポートしているため、さまざまなプロジェクトに適応可能で広く適用されます。

開発者は、DocFXを使用して、ドキュメント内にチュートリアル、概念記事、およびAPIリファレンスを作成できます。 その柔軟なアーキテクチャによって、チームは独自の要件に合わせてカスタマイズおよび拡張することができます。 DocFXは、クロスリファレンス、編集可能なテンプレート、HTMLやMarkdownを含む複数の出力形式のサポートなどの機能も提供しています。 DocFXの内部構造と方法についての詳細な説明は、こちらをご覧ください。DocFXドキュメント.

DocFXの使い始め

DocFXのセットアップ

DocFXの使用は非常に簡単です。 それには、Microsoft の .NET パッケージマネージャーである NuGet を使用して DocFX SDK を追加します。 DocFXを使用してウェブコンテンツをアプリケーションに組み込むために必要なライブラリとツールが、このSDKに含まれています。

新しい DocFX Webサイトを作成

このフェーズでは、ローカルコンピュータ上に基本的なドキュメントウェブサイトを作成します。

• コマンドライン操作の基本的な理解が必要です。

• .NET SDKバージョン6.0以降が必要です。

  DocFXの最新バージョンをインストールするには、.NET SDKがインストールされていることを確認し、ターミナルのコマンドラインツールを開いて次のコマンドを入力してください：

dotnet tool update -g docfx

新しいドキュメントセットを開始するには、以下を実行してください：

docfx init

それは、すべての設定のJSONファイルを作成します。 このコマンドを使用すると、現在の作業ディレクトリに新しいDocFXプロジェクトを作成できます。 ドキュメントセットを作成するには、次を実行します:

docfx docfx.json --serve

ウェブページは現在、http://localhost:8080でプレビューとして表示できます。

変更を保存します。DocFXはJSON設定ファイルを使用して構成されています。次に、新しいターミナルを使用してこのコマンドを実行し、ウェブサイトを再構築してローカルの変更をプレビューします。

docfx docfx.json

DocFXの特徴

柔軟かつ拡張可能

DocFXは、多数のマークアップフォーマットやプログラミング言語と互換性があり、JSONファイル、YAML、およびMarkdownなどに対応しています。 この柔軟性により、チームは自分たちの要件や好みに最も適したフォーマットを選択できます。 さらに、DocFXの拡張可能なアーキテクチャにより、プログラマーはプラグインやテンプレートを通じてその機能を追加および修正でき、さまざまなドキュメントのニーズに対応できます。

API ドキュメント生成

DocFXは、ソースコードにあるコメントからAPIドキュメントを作成するのに役立つ優れたツールです。 DocFXは、XMLやYAMLのような広く使用されている形式のコードコメントを解析することによって、名前空間、クラス、メソッド、パラメーター、リターンタイプを含むAPIリファレンスドキュメントを自動的に作成します。 この機能はコードAPIのドキュメント作成プロセスを合理化することで、開発者の時間と労力を大幅に節約します。

クロスプラットフォーム互換性

DocFXはクロスプラットフォームなので、Linux、macOS、およびWindowsシステムで動作可能です。 開発チームが使用するオペレーティングシステムに関係なく、このクロスプラットフォーム互換性は、ドキュメント生成をさまざまな開発ワークフローや環境に簡単に組み込むことを保証します。

内蔵検索とナビゲーション

DocFXは、生成されたドキュメント内でのナビゲーションおよび検索の統合サポートを提供します。 ユーザーが簡単にドキュメント内のトピック、API、またはキーワードを検索できることにより、関連情報への迅速なアクセスが可能になります。 ユーザビリティとユーザー体験をさらに向上させるために、DocFXは目次も作成します。(目次)ユーザーがドキュメント階層を簡単に閲覧できるようにします。

IronPDFを使用したDocFXの統合

DocFXとIronPDFを組み合わせることで、開発者はそれぞれのツールの利点を活用し、ドキュメント作成プロセスを改善することができます。 開発者は、IronPDFを使用してDocFXで生成されたHTMLドキュメントをPDF形式に変換することで、デバイス間で一貫したレンダリングを確保し、オフライン対応のドキュメントを作成し、共有および配布を容易にすることができます。 IronPDFについてもっと知りたい方はIronPDF ドキュメント.

IronPDF をインストール

• Visual Studio プロジェクトを開始します。
• 「ツール」 > 「NuGet パッケージ マネージャー」 > 「パッケージ マネージャー コンソール」を選択します。
• Visual Studio パッケージ マネージャー コンソールで、次のコマンドを入力します:

Install-Package IronPdf

• または、ソリューションのためにNuGetパッケージマネージャを使用してIronPDFをインストールすることもできます。

• 検索結果からIronPDFパッケージを選択し、「インストール」オプションをクリックしてください。 Visual Studioは、ダウンロードおよびインストールを代わりに処理します。

  

• NuGet は、IronPDF パッケージおよびプロジェクトに必要なすべての依存関係をインストールします。
• インストール後、IronPDF をプロジェクトで利用できます。

NuGetウェブサイトを通じてインストール

IronPDFの機能、互換性、利用可能なダウンロードに関する追加情報については、IronPDFのウェブサイトをご覧ください。NuGetパッケージNuGetウェブサイトのページ。

DLL を使用してインストール

代わりに、DLLファイルを利用してIronPDFをプロジェクトに直接統合することもできます。DLLを含むZIPファイルをダウンロードするには、こちらをクリックしてください。DLLダウンロードページ. ファイルを解凍し、DLLをプロジェクトに追加してください。

ロジックの実装

以下のロジックは統合プロセスに関連しています:

1. DocFXを使用してドキュメントを作成: DocFXを使用してドキュメントを作成しましょう。 HTMLドキュメントを生成するためには、プロジェクトのソースコードとMarkdownファイルに対してDocFXビルドプロセスを実行することが必要です。

2. IronPDF を使用して HTML ドキュメントを PDF に変換: HTML ドキュメントが作成された後、IronPDF を使用してプログラム的に PDF 形式に変換します。 HTMLテキストを印刷可能なPDFドキュメントに変換するのは、IronPDFのHTML-to-PDF変換機能を使用すると簡単です。

3. 変換プロセスの自動化: ワークフローを最適化するために、C#コードやスクリプトを使用して変換プロセスを自動化します。 これにより、手動で介入が必要な場合でも、ドキュメントを簡単に更新および再生成できることが保証されます。

using IronPdf;
        var Renderer = new IronPdf.HtmlToPdf();
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");
        // Save PDF to file
        PDF.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();

using IronPdf;
        var Renderer = new IronPdf.HtmlToPdf();
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");
        // Save PDF to file
        PDF.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();

Imports IronPdf
		Private Renderer = New IronPdf.HtmlToPdf()
		Private PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html")
		' Save PDF to file
		PDF.SaveAs("output.pdf")
		Console.WriteLine("PDF generated successfully!")
		Console.ReadKey()

コード例の詳細については、こちらをご覧ください。使用ガイドの例. 実行結果は以下に示されています:

結論

ついに、開発者はDocFXをIronPDFとC#で統合することにより、優れたPDF形式のドキュメントを作成および配布するための強力なオプションを手に入れました。 開発者は、DocFXとIronPDFのPDF生成機能を組み合わせて、広範なオフライン対応のドキュメントを作成し、容易にアクセスおよび共有できるドキュメントを生成することができます。 この統合により、ソフトウェアプロジェクトの成功率が向上し、ドキュメントのワークフローが改善され、プロジェクトドキュメントが読みやすく、アクセスしやすくなります。

開発者は、この記事の推奨事項を実施し、DocFXおよびIronPDFの機能を活用することで、ドキュメント作成手順を最適化し、チームワークとコミュニケーションを改善し、ユーザーと利害関係者に対してより良いドキュメント作成体験を提供することができます。

$749のLiteバンドルには、永続ライセンス、1年間のソフトウェアメンテナンス、およびライブラリのアップグレードが含まれています。 IronPDFは再配布と時間に制限のある無料ライセンスを提供しています。ユーザーは試用期間中、透かしを視認することなくソリューションを評価できます。 価格とライセンスの詳細については、IronPDF'sをご覧ください。ライセンス詳細. こちらへ移動Iron ソフトウェアライブラリのページIron Software ライブラリに関する追加情報については。