Question

我一直关注this guide使用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
Pure 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

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

1 个答案: