Как настроить swagger-ui?

Question

Я изучаю чванство, пытаясь внести небольшое изменение и посмотреть, можно ли его отразить на индексной странице. Итак, отправной точкой является страница 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.

Но я заметил, что у него есть .gz-файл для исходного файла index.html, не знаю его цели, поэтому я также создал файл 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 ERROR 404

Проблема доступа /swagger-ui/webjars/swagger-ui/2.1.8- М1/index2.html. Причина:

Not Found 

Answer 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 

Answer 2

Что именно вы пытаетесь изменить в Swagger-UI? Я возился с брендингом/настройкой Swagger. Если вы посмотрите файл swagger-ui.js, вы увидите, что он содержит 30 000 строк кода и плохо организован. Они также используют рули и backbone.js, с которыми я не знаком. Я добавил некоторые пользовательские функции, просто манипулируя DOM после того, как страница была отображена. Я сделал это, написав JS-файл, который был добавлен в index.html.