For some REST APIs written in PHP, I was asked to create Swagger documentation, and since I was not aware of any easy way of adding annotations to those existing APIs and create such a documentation, I used this editor to generate some for now.
I saved the JSON and YAML files created using that editor, and now I need to create the final interactive Swagger documentation (this statement might sound naive and vague).
Can someone please let me know how I can convert the Swagger JSON specification file to actual Swagger documentation?
I am on the Windows platform and do not know anything about Ant/Maven.
This question is tagged with
~ Asked on 2014-09-12 03:57:56
I was not satisfied with
swagger-codegen when I was looking for a tool to do this, so I wrote my own. Have a look at bootprint-swagger
The main goal compared to
swagger-codegen is to provide an easy setup (though you'll need nodejs).
And it should be easy to adapt styling and templates to your own needs, which is a core functionality of the bootprint-project
~ Answered on 2015-06-28 06:25:30
Try to use redoc-cli.
I was using bootprint-openapi by which I was generating a bunch of files (
main.css.map) and then you can convert it into a single
.html file using html-inline to generate a simple
Then I found redoc-cli very easy to to use and output is really-2 awesome, a single and beautiful index.html file.
npm install -g redoc-cli
redoc-cli bundle -o index.html swagger.json
~ Answered on 2018-06-22 07:45:29