asp.net - 如何从 Swashbuckle.AspNet 生成多个页面？

Question

我一直在关注 this guide使用 Swashbuckle 为我的 ASP.Net REST WebApi 创建开发人员友好的文档。
但是，当前版本Swashbuckle.AspNetCore v2.2.0生成一个巨大的单页应用程序，这让我的用户感到困惑。
如果我没记错的话，Swashbuckle 为每个 Controller /方法生成单独的页面(2017 年初？)。我的配置如下所示:

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "API V1");
    c.EnableFilter();
    c.MaxDisplayedTags(5);
});

问:有没有办法让 Swagger-UI 为每个 Controller 和方法生成单独的页面，而不是一个巨大的单一滚动困惑？

更多细节:

VS2017

Microsoft.AspNetCore 2.0.0

Microsoft.AspNetCore.Mvc 2.0.0

Swashbuckle.AspNetCore 2.2.0

纯 WebApi - 仅生成 JSON，根本不生成 HTML。

通过 Kestrel 自托管

Windows 使用 net 4.6.2(此处使用 Swashbuckle)

或使用 dotnet core 2.0 的嵌入式 Linux(禁用 Swashbuckle)

Answer 1

Swashbuckle.AspNetCore v2.2.0 支持将 API 操作任意分组到多个 Swagger 文档中。

请引用此处的文档:
https://github.com/domaindrivendev/Swashbuckle.AspNetCore#generate-multiple-swagger-documents