DocFx生成Asp.NetCore文档

前言

在看微软官方文档的时候,提到”To build the API Browser, we used open standards and tools. At its core, we leveraged DocFX - the open documentation generation toolchain, along with Xamarin’s mdoc application.”
微软的.Net文档是通过DocFx来生成,通过该工具,可以在本地内网容器环境搭建Asp.Net Core的文档。

DocFx

1、下载DocFx(github releases),windows系统设置环境变量
2、执行命令,生成一个初始化的dockfx项目

1
docfx init -q

3、将Asp.Net Core源码中的src拷贝到上述生成的项目的src目录中
4、执行命令,构建API文档。docfx.json可以设置默认的icon、logo等信息。
1
docfx docfx_project\docfx.json --serve