programing

swagger-ui에 대한 테마가없는 이유는 무엇입니까?

nasanasas 2020. 12. 24. 23:48
반응형

swagger-ui에 대한 테마가없는 이유는 무엇입니까?


저는 Restful API를 문서화하는 것을 매우 좋아합니다. 특히 "사용해보세요!" 버튼이지만 swagger-ui인터페이스가별로 멋지지 않습니다.

그런 놀라운 오픈 소스 도구에 대한 템플릿이 없다는 것을 믿을 수 없습니까 (아니면 찾을 수 없습니다)?

나는 그것을 무료로 원하지 않는다 .. http://getbootstrap.com/ 처럼 테마를 구입할 수있는 사이트가 많다 ( https://wrapbootstrap.com/ 같은 ), 왜 나는 테마가있는 사이트를 찾을 수 없습니까?


좋은 답변이지만 늦은 답변. 이것은 꽤 굉장합니다! 매끄러운 구현, 그리고 그는 당신의 필요에 맞게 조정하기 쉬운 많은 것들을 사용자 정의했습니다 : https://github.com/jensoleg/swagger-ui .

크레딧은 다음 Google 그룹으로 이동합니다 : https://groups.google.com/forum/#!topic/swagger-swaggersocket/oeMyayrvKRI . 이것이 아직 여기에 게시되지 않은 것이 이상합니다.

액션 데모를 보려면 다음 링크를 확인하십시오 : http://senodio.com/site/swagger/#!/pet/addPet

-

편집 : 최근 DEMO가 다운되었음을 발견했기 때문에 Repo ( https://github.com/MartinSahlen/swagger-ui )를 포크하고 heroku에서 실행되는 간단한 노드 / 익스프레스 서버를 만들었습니다. 이것은 무료 heroku dyno이므로 일정 시간 동안 활동이 적은 경우로드하는 데 시간 (~ 20 초)이 걸릴 수 있습니다.

천만에요 : http://sleepy-harbor-80783.herokuapp.com/#!/pet/addPet

편집 2 : 유망 해 보이는 또 다른 것을 발견했습니다 : https://github.com/legendecas/material-swagger-ui . 또한 내가 지금 호스팅하고있는 swagger ui가 http://swaggerui.herokuapp.com/ 에서 부활 한 것 같습니다 . 다시 쓰러 질 경우를 대비하여 내 것도 보관하십시오.


Swagger UI에 적용 할 수있는 스타일 시트 테마 모음입니다. 사용 방법에 대한 내 저장소에 아래 링크.

도움이 되었기를 바랍니다.

https://github.com/ostranme/swagger-ui-themes


Swagger-UI는 새로운 도구는 아니지만 해당 작업에 매우 구체적입니다. 테마를 제공하는 웹 사이트 (무료 또는 유료)를 알지 못합니다. 많은 사용자가 지역 테마에 맞게 UI를 사용자 정의했습니다. 일부는 미묘한 변화를, 일부는 완전한 점검을했습니다.

사용 가능한 구현을 살펴보고 필요한 것이 있는지 확인하는 것이 좋습니다. 그런 다음 자신의 필요에 맞게 테마 / 템플릿을 재사용 할 수있는 권한을 요청하십시오.


또 다른 옵션은 ReDoc 입니다.

index.html 과 함께 swagger.json 파일 을 가져 오면 됩니다 . 간편한 설정.

<head>
    <title>ReDoc</title>
    <meta charset="utf-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
    <style>
      body {
        margin: 0;
        padding: 0;
      }
    </style>
  </head>
  <body>
    <redoc spec-url='your.swagger.json'></redoc>
    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
  </body>

나는 최근에 관심있는 모든 사람들을 위해 부트 스트랩 v4를 사용하여 위에서 공유 한 swagger-ui 테마를 리팩토링했습니다. 여기에서 확인 하십시오 https://github.com/afgarcia86/bootstrap-swagger-ui

참조 URL : https://stackoverflow.com/questions/28033075/why-there-are-no-themes-for-swagger-ui

반응형