Disclaimer

I am currently reviewing my most important projects from GitHub and trying to implement new features to it, so updates will be coming soon.

This repository is part of my final project for the Java School of T-Systems Iberia and contains the API specifications hosted on GitHub. For further information please refer to my documentation at https://miguelpelegrina.github.io/java_school_online_store_documentation/.

How to host Swagger API documentation with GitHub Pages

This repository is a template for using the Swagger UI to dynamically generate beautiful documentation for your API and host it for free with GitHub Pages.

The template will periodically auto-update the Swagger UI dependency and create a pull request. See the GitHub Actions workflow here.

The example API specification used by this repository can be seen hosted at https://peter-evans.github.io/swagger-github-pages.

Steps to use this template

1. Click the Use this template button above to create a new repository from this template.

2. Go to the settings for your repository at https://github.com/{github-username}/{repository-name}/settings and enable GitHub Pages.

   

3. Browse to the Swagger documentation at https://{github-username}.github.io/{repository-name}/.

Steps to manually configure in your own repository

1. Download the latest stable release of the Swagger UI here.

2. Extract the contents and copy the "dist" directory to the root of your repository.

3. Move the file "index.html" from the directory "dist" to the root of your repository.

   mv dist/index.html .
   

4. Copy the YAML specification file for your API to the root of your repository.

5. Edit dist/swagger-initializer.js and change the url property to reference your local YAML file.

       window.ui = SwaggerUIBundle({
           url: "swagger.yaml",
       ...

   Then fix any references to files in the "dist" directory.

   ...
   <link rel="stylesheet" type="text/css" href="dist/swagger-ui.css" >
   <link rel="icon" type="image/png" href="dist/favicon-32x32.png" sizes="32x32" />
   <link rel="icon" type="image/png" href="dist/favicon-16x16.png" sizes="16x16" />    
   ...
   <script src="dist/swagger-ui-bundle.js"> </script>
   <script src="dist/swagger-ui-standalone-preset.js"> </script>    
   ...

6. Go to the settings for your repository at https://github.com/{github-username}/{repository-name}/settings and enable GitHub Pages.

   

7. Browse to the Swagger documentation at https://{github-username}.github.io/{repository-name}/.

   The example API specification used by this repository can be seen hosted at https://peter-evans.github.io/swagger-github-pages.