|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990 |
- # <img src="https://raw.githubusercontent.com/swagger-api/swagger.io/wordpress/images/assets/SWU-logo-clr.png" height="80">
-
- [![NPM version](https://badge.fury.io/js/swagger-ui.svg)](http://badge.fury.io/js/swagger-ui)
- [![Build Status](https://jenkins.swagger.io/view/OSS%20-%20JavaScript/job/oss-swagger-ui-master/badge/icon?subject=jenkins%20build)](https://jenkins.swagger.io/view/OSS%20-%20JavaScript/job/oss-swagger-ui-master/)
-
- **👉🏼 Want to score an easy open-source contribution?** Check out our [Good first issue](https://github.com/swagger-api/swagger-ui/issues?q=is%3Aissue+is%3Aopen+label%3A%22Good+first+issue%22) label.
-
- **🕰️ Looking for the older version of Swagger UI?** Refer to the [*2.x* branch](https://github.com/swagger-api/swagger-ui/tree/2.x).
-
-
- This repository publishes to three different NPM modules:
-
- * [swagger-ui](https://www.npmjs.com/package/swagger-ui) is a traditional npm module intended for use in single-page applications that are capable of resolving dependencies (via Webpack, Browserify, etc).
- * [swagger-ui-dist](https://www.npmjs.com/package/swagger-ui-dist) is a dependency-free module that includes everything you need to serve Swagger UI in a server-side project, or a single-page application that can't resolve npm module dependencies.
- * [swagger-ui-react](https://www.npmjs.com/package/swagger-ui-react) is Swagger UI packaged as a React component for use in React applications.
-
- We strongly suggest that you use `swagger-ui` instead of `swagger-ui-dist` if you're building a single-page application, since `swagger-ui-dist` is significantly larger.
-
-
- ## Compatibility
- The OpenAPI Specification has undergone 5 revisions since initial creation in 2010. Compatibility between Swagger UI and the OpenAPI Specification is as follows:
-
- Swagger UI Version | Release Date | OpenAPI Spec compatibility | Notes
- ------------------ | ------------ | -------------------------- | -----
- 3.18.3 | 2018-08-03 | 2.0, 3.0 | [tag v3.18.3](https://github.com/swagger-api/swagger-ui/tree/v3.18.3)
- 3.0.21 | 2017-07-26 | 2.0 | [tag v3.0.21](https://github.com/swagger-api/swagger-ui/tree/v3.0.21)
- 2.2.10 | 2017-01-04 | 1.1, 1.2, 2.0 | [tag v2.2.10](https://github.com/swagger-api/swagger-ui/tree/v2.2.10)
- 2.1.5 | 2016-07-20 | 1.1, 1.2, 2.0 | [tag v2.1.5](https://github.com/swagger-api/swagger-ui/tree/v2.1.5)
- 2.0.24 | 2014-09-12 | 1.1, 1.2 | [tag v2.0.24](https://github.com/swagger-api/swagger-ui/tree/v2.0.24)
- 1.0.13 | 2013-03-08 | 1.1, 1.2 | [tag v1.0.13](https://github.com/swagger-api/swagger-ui/tree/v1.0.13)
- 1.0.1 | 2011-10-11 | 1.0, 1.1 | [tag v1.0.1](https://github.com/swagger-api/swagger-ui/tree/v1.0.1)
-
- ## Documentation
-
- #### Usage
- - [Installation](docs/usage/installation.md)
- - [Configuration](docs/usage/configuration.md)
- - [CORS](docs/usage/cors.md)
- - [OAuth2](docs/usage/oauth2.md)
- - [Deep Linking](docs/usage/deep-linking.md)
- - [Limitations](docs/usage/limitations.md)
- - [Version detection](docs/usage/version-detection.md)
-
- #### Customization
- - [Overview](docs/customization/overview.md)
- - [Plugin API](docs/customization/plugin-api.md)
- - [Custom layout](docs/customization/custom-layout.md)
-
- #### Development
- - [Setting up](docs/development/setting-up.md)
- - [Scripts](docs/development/scripts.md)
-
- ##### Integration Tests
-
- You will need JDK of version 7 or higher as instructed here
- http://nightwatchjs.org/gettingstarted#selenium-server-setup
-
- Integration tests can be run locally with `npm run e2e` - be sure you aren't running a dev server when testing!
-
- ### Browser support
- Swagger UI works in the latest versions of Chrome, Safari, Firefox, Edge and IE11.
-
- ### Known Issues
-
- To help with the migration, here are the currently known issues with 3.X. This list will update regularly, and will not include features that were not implemented in previous versions.
-
- - Only part of the parameters previously supported are available.
- - The JSON Form Editor is not implemented.
- - Support for `collectionFormat` is partial.
- - l10n (translations) is not implemented.
- - Relative path support for external files is not implemented.
-
- ## Security contact
-
- Please disclose any security-related issues or vulnerabilities by emailing [security@swagger.io](mailto:security@swagger.io), instead of using the public issue tracker.
-
- ## License
-
- Copyright 2019 SmartBear Software
-
- 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](http://www.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.
-
|