docfx - 如何在没有 VS2017 的情况下使用 DocFX 从源代码生成 c# 文档？

Question

我正在尝试从命令行遵循教程。我已经生成了项目并部署了空白网站，然后在源文件夹中添加了一个 vs2012 项目来维护原始层次结构。我已经编辑了 docfx.json 文件以包含“src/ .csproj”“src/ .cs*”，我假设它是递归搜索的。该项目之前曾被评论为与 SandCastle 一起使用，因此应该有很多可以从中提取或生成元数据的内容。我目前安装了 vs2012 msdn。我的问题是元数据永远不会构建，即使我使用示例种子项目，所有 md 文件都会显示在 webhost 上，但不会显示源文件中的文档。

Answer 1

无需安装完整的 VS2017，只需安装 VS2017 的构建工具即可。下载

只需启动 VS2017 环境的开发人员提示并从那里执行 docfx，它就应该能够提取元数据。由于某种原因，我在使用docfx 和旧版Visual Studio 工具的VB.NET 项目中遇到了问题。