docfx C#（开发人员如何使用）

如何使用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新网站

在此阶段，我们将在您的本地计算机上创建一个基本的文档网站。

• 需要对命令行操作有基本的了解。
• 需要.NET SDK 6.0或更高版本。

要安装DocFX的最新版本，请确保您已安装.NET SDK，然后打开终端命令行工具并键入以下命令：

dotnet tool update -g docfx

要开始一个新的文档集，请执行以下操作：

docfx init

docfx init

它会创建包含所有配置的JSON文件。 借助该命令，您可以在当前工作目录中创建一个新的DocFX项目。 要创建文档集，请执行：

docfx docfx.json --serve

docfx docfx.json --serve

网页现在可以在http://localhost:8080上预览。

保存您的更改。 DocFX使用JSON配置文件进行配置。现在，我们正在使用一个新的终端来执行此命令，以重建网站并预览您的本地更改：

docfx docfx.json

docfx docfx.json

DocFX的功能

将DocFX与IronPDF集成

通过将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。

实施逻辑

集成过程涉及以下逻辑：

1. 使用DocFX创建文档： 首先，使用DocFX创建文档。 这涉及到在项目的源代码和Markdown文件上执行DocFX构建过程以生成HTML文档。
2. 使用IronPDF将HTML文档转换为PDF： 在创建HTML文档后，利用IronPDF以编程方式将其转换为PDF格式。 使用IronPDF的HTML到PDF转换功能，可以轻松将HTML文本转换为可打印的PDF文档。
3. 自动化转换过程： 使用C#代码或脚本自动化转换过程以优化工作流程。 这确保了文档即使在不需要人工干预的情况下也可以轻松更新并重新生成。

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Create a new HtmlToPdf Renderer
		Dim Renderer = New HtmlToPdf()

		' Render the webpage as PDF
		Dim PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html")

		' Save PDF to a file
		PDF.SaveAs("output.pdf")

		' Inform the user of successful PDF creation
		Console.WriteLine("PDF generated successfully!")
		Console.ReadKey()
	End Sub
End Class

要阅读更多关于代码示例的信息，请参阅此示例使用指南。 执行输出如下所示：

结论

最后，通过在C#中将DocFX与IronPDF结合使用，开发人员拥有了一种用于创建和传播PDF格式出色文档的强大方案。 通过结合DocFX和IronPDF用于文档生成的PDF生产功能，开发人员可以生成广泛的、离线就绪的文档，这些文档易于访问和共享。 这种集成增强了文档工作流程，提高了项目文档的可读性和可访问性，并增加了软件项目成功的可能性。

通过实施本文中的建议并利用DocFX和IronPDF的功能，开发人员可以优化他们的文档程序，改善团队合作和沟通，为用户和利益相关者提供更好的文档体验。

$799 Lite捆绑包包含永久许可证、一年的软件维护和库的升级。 IronPDF提供具有重新分发和时间限制的免费许可证。用户可以在试用期期间评估解决方案，而不必看到水印。 有关价格和许可证的更多信息，请参阅IronPDF的许可证详情。