[Memo] Docfx 微软新一代文档生成工具

Microsoft .NET

• 下载 docfx.console 命令行工具

  • 推荐使用 NuGet 下载

  nuget.exe Install docfx.console -Version 2.47.0
  

• Docfx 初始化

  docfx.exe init --apiSourceFolder "{Your Source Folder}"
  // 备注: --apiSourceFolder 一般指向代码 src 目录的上级目录
  

  之后一路回车即可

• 含代码构建

  docfx.exe docfx.json
  // 备注：docfx.json 是 init 命令生成的配置文件
  

• 启动 Docfx 服务预览

  docfx.exe serve _site -p 9000
  // 备注：_site 为 docfx 默认的构建生成目录