3

我正在学习招摇，尝试做一点改变，看看它是否可以反映在索引页面上。所以起点是 index.html 页面，我从 jar 文件中复制了它：

C:\swagger-ui\target\swagger-ui-2.1.0-M1\WEB-INF\lib\swagger-ui-2.1.8-M1.jar

并将新建的页面保存为index2.html，在里面的html内容中添加一行，添加到上面的jar文件中。

但是我注意到它有一个原始index.html文件的.gz文件，不知道它的用途，所以我还制作了一个名为index2.html.gz的文件并将其添加到上面的jar文件中，然后运行码头服务器，并加载 index.html ： http://localhost:8080/swagger-ui/webjars/swagger-ui/2.1.8-M1/index.html

它显示正常，然后我尝试加载：index2.html，但找不到页面，为什么？我应该在哪里包含它，以便它显示在：http://localhost:8080/swagger-ui/webjars/swagger-ui/2.1.8-M1/index2.html

错误信息是：

HTTP 错误 404

访问 /swagger-ui/webjars/swagger-ui/2.1.8-M1/index2.html 时出现问题。原因：

Not Found
4

2 回答 2

1

您到底想在 Swagger-UI 中更改什么？我自己一直在搞品牌/定制 Swagger。如果您查看 swagger-ui.js 文件，您会发现它有 30,000 多行代码并且组织得很差。他们还使用了我不熟悉的车把和骨干网。在页面渲染完成后，我通过简单地操作 DOM 添加了一些自定义功能。我通过编写一个添加到 index.html 的 JS 文件来做到这一点。

于 2015-07-23T15:50:01.377 回答
1 
I got it done with the following steps :

[1] Create : C:\swagger-ui\petstore
[2] Copy swagger.json into it [ This is where you can customize ]
[3] Copy the index.html and save it as : Swagger_Test.html into C:\swagger-ui\src\main\webapp [ This is where you can customize ]
[4] Unpack swagger-ui-2.1.8-M1.jar into : C:\swagger-ui\src\main\webapp
[5] Create C:\swagger-ui\src\main\webapp\css and move the *.css and  *.css.gz files mentioned in the original index.html file from C:\swagger-ui\src\main\webapp to C:\swagger-ui\src\main\webapp\css
[6] Create C:\swagger-ui\src\main\webapp\lib and move the *.js and *.js.gz files mentioned in the original index.html file from C:\swagger-ui\src\main\webapp to C:\swagger-ui\src\main\webapp\lib
[7] Maybe move another few files in the original index.html file from C:\swagger-ui\src\main\webapp to C:\swagger-ui\src\main\webapp\css or C:\swagger-ui\src\main\webapp\lib
[8] Comment out the following from the pom file

<dependency>
  <groupId>org.webjars</groupId>
  <artifactId>swagger-ui</artifactId>
  <version>2.1.8-M1</version>
</dependency>

[9] In the Swagger_Test.html file
    replace : url = "http://petstore.swagger.io/v2/swagger.json";
       with : url = "/swagger-ui/petstore/swagger.json";

[10] Recompile and start the server
[11] Load page : http://localhost:8080/swagger-ui/Swagger_Test.html
            or : http://localhost:8080/swagger-ui/Swagger_Test.html?url=http://localhost:8080/swagger-ui/petstore/swagger.json
于 2015-07-23T16:14:36.773 回答