如何使用DocFx为解决方案中的其他项目生成文档

时间:2016-02-23 22:02:58

标签: documentation-generation docfx

我正在使用DocFx在Visual Studio 2015中自动生成文档。

根据Getting Started说明,我添加了一个空的ASP.NET 4 Web应用程序,并使用Nuget控制台安装DocFx构建包(例如Install-Package docfx.msbuild)。我构建了网站,它为项目中的代码生成了文档。

我想知道如何配置 docfx.json 以让DocFx在解决方案中的其他项目中记录代码。

2 个答案:

答案 0 :(得分:12)

docfx.json 中,有一个metadata数组。示例metadata包含srcfilesexclude属性的对象。

要指向解决方案中的另一个项目,请将cwd属性添加到metadata并更改文件夹(即" ../ Another.Project")。

{ "metadata": [ { "src": [ { "files": [ "**/*.csproj" ], "exclude": [ "**/bin/**", "**/obj/**", "_site/**" ], "cwd": "../Another.Project" } ], "dest": "obj/api" } ], "build": ... }

答案 1 :(得分:0)

这对我有用。

目录结构

+---ClassLibrary
|   \---ClassLibrary.csproj
\---DocFxProject
    \---docfx.json

docfx.json内容 cwdsrc是同一属性的同义词

{
  "metadata":
  [ 
    {
      "src":
      [
        {
          "files": [ "**/ClassLibrary.csproj" ],
          "src": "..",
          "exclude": [ "**/obj/**", "**/bin/**" ]
        } 
      ],
      "dest": "obj/api"
    }
  ],
  "build": { ... }
}