如何从Swashbuckle.AspNet生成多个页面

Question

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

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

问：有没有办法让 Swagger-UI 为每个控制器和方法生成单独的页面，而不是一个巨大的滚动混乱？

更多细节：

• VS2017
• Microsoft.AspNetCore 2.0.0
• Microsoft.AspNetCore.Mvc 2.0.0
• Swashbuckle.AspNetCore 2.2.0
• 纯WebApi - 只生成JSON，根本没有HTML。
• 通过红隼自托管 上
  • 要么使用网络 4.6.2 的 Windows(这里使用 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