GitHub - swagger-api/swagger-ui at v1.0.1 (original) (raw)

Swagger UI

Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API. Because Swagger UI has no dependencies, you can host it in any server environment, or on your local machine.

How to Use It

wget https://github.com/downloads/wordnik/swagger-ui/swagger-ui-1.0.zip unzip swagger-ui-1.0.zip open swagger-ui-1.0/index.html

How to Improve It

First, create your own fork of wordnik/swagger-ui

To hack on swagger-ui, you'll need ruby. Then..

Install the middleman gem:

gem install middleman

Start up a development server on http://localhost:4567

middleman

Edit the files in /source

Then when you're ready to build, run:

middleman build

To share your changes, submit a pull request.

License

Copyright 2011 Wordnik, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.