asp.net - 完全替换 Swashbuckle UI

Question

现在我正在开发一个 ASP.Net Web API 并使用 Swashbuckle 作为它的文档。
我知道 Swashbuckle 内部使用 Swagger-UI，我知道我们可以通过注入(inject)我们的 css 或 javascript 文件来修改布局，甚至可以更改 index.html 的布局。

我为 Swagger-UI 找到了一个很好的主题 https://github.com/jensoleg/swagger-ui并试图实现它但无法使其工作。特别是当我想注入(inject) bootstrap.js 时。无论如何我可以完全改变 Swashbuckle Swagger UI 实现，以便我可以使用该 repo 中的解决方案吗？

Answer 1

当然可以 - 分两步。

1) 将文件 Index.html 作为嵌入式资源包含在您的程序集中。例如，假设您的 Web api 项目名为“Contosco.Api”，Index.html 将位于该项目的“/Content/Index.html”下。

2) 用你自己的覆盖 swagger UI 主 html 页面

[assembly: PreApplicationStartMethod(typeof(SwaggerConfig), "Register")]
public class SwaggerConfig 
{
  public static void Register()
  {
    var thisAssembly = typeof(SwaggerConfig).Assembly;
    GlobalConfiguration.Configuration.EnableSwagger(c => {
     // configure swagger
    })
    .EnableSwaggerUi(c => {
      // beware - the Contosco.Api.Content.Index.html has to match your project paths :)
      c.CustomAsset("index", thisAssembly, "Contosco.Api.Content.Index.html");
    });
  }
}