我可以将Swashbuckle与多个与端点无关的文档一起使用吗？

Question

我正在构建一个ASP.NET Core Web API，使用Swashbuckle生成一个swagger doc页面。我已经使用Info对象来自定义描述，但我想知道Swashbuckle是否支持添加其他文档。例如，架构文档，示例应用程序等。比我想要的描述更多。我知道我可以在Into.Description中有链接指向其他页面的链接，但我希望重用swagger页面的格式和视觉，所以看起来大致相同。

Swashbuckle是否支持其他页面链接？

Answer 1

Swashbuckle旨在为您的WebApi生成一个swagger文档（OAS 2.0），并且该swagger doc受该规范的限制：
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md

另一个限制是UI，Swashbuckle使用Swagger-UI这是一个单独的项目，它确实提供了一些自定义，但我害怕不是你想要的：
https://github.com/swagger-api/swagger-ui#documentation

Swashbuckle可以选择注入资源并自定义目标网页： https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/master/README.md#inject-custom-css

好事是Swashbuckle＆amp; Swagger-UI是开源的，所以如果你需要更改核心功能，你可以！