Update docs

Author: blueswen

demo-mkdocs/docs/demo/build-in-multiple.md

@@ -10,11 +10,17 @@ Add two attribute in swagger-ui tag:
 The Swagger UI with multiple OAS takes the first grouped swagger-ui tag position.
 
 ```html
+## Multiple OAS in single Swagger UI
+
 <swagger-ui grouped name="Pet Store" src="https://petstore.swagger.io/v2/swagger.json"/>
 <swagger-ui grouped name="Sample" src="./openapi-spec/sample.yaml"/>
 <swagger-ui grouped name="Sample First" src="./openapi-spec/sample-first.yaml"/>
 <swagger-ui grouped name="Sample Second" src="./openapi-spec/sample-second.yaml"/>
 <swagger-ui grouped name="Sample Third" src="./openapi-spec/sample-third.yaml"/>
+
+## Other independent Swagger UI
+
+<swagger-ui src="./openapi-spec/sample.yaml"/>
 ```
 
 ## Multiple OAS in single Swagger UI

demo-mkdocs/docs/demo/multiple.md

@@ -4,10 +4,12 @@ Support render multiple Swagger UI.
 
 ```html
 <swagger-ui src="./openapi-spec/sample.yaml"/>
+<swagger-ui src="./openapi-spec/sample-oauth2.yaml"/>
 <swagger-ui src="https://petstore.swagger.io/v2/swagger.json"/>
 ```
 
 ## Swagger UI
 
 <swagger-ui src="./openapi-spec/sample.yaml"/>
+<swagger-ui src="./openapi-spec/sample-oauth2.yaml"/>
 <swagger-ui src="https://petstore.swagger.io/v2/swagger.json"/>

demo-mkdocs/docs/demo/pet-store-full-width.md

@@ -0,0 +1,23 @@
+---
+hide:
+  - navigation
+  - toc
+---
+
+When using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) you can [hide the sidebar](https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#hiding-the-sidebars) to get full width Swagger UI in page.
+
+## Markdown
+
+```html
+---
+hide:
+  - navigation
+  - toc
+---
+
+<swagger-ui src="https://petstore.swagger.io/v2/swagger.json"/>
+```
+
+## Swagger UI
+
+<swagger-ui src="https://petstore.swagger.io/v2/swagger.json"/>

demo-mkdocs/docs/index.md

@@ -6,7 +6,7 @@ A MkDocs plugin supports for add [Swagger UI](https://github.com/swagger-api/swa
 
 1. OpenAPI Specification file from online over URL or static file in docs 
 2. Multiple Swagger UI in same page
-3. Synchronized dark mode with [mkdocs-material](https://squidfunk.github.io/mkdocs-material/)
+3. Synchronized dark mode with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)
 4. Configure [Swagger UI configuration](https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/) through plugin options and tag attributes
 5. Support multiple OAS in single Swagger UI with top bar selector
 6. Support Swagger UI [initOAuth](https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/) method
@@ -16,7 +16,7 @@ A MkDocs plugin supports for add [Swagger UI](https://github.com/swagger-api/swa
 1. Python Package
     1. beautifulsoup4>=4.11.1
 2. [Swagger UI dist](https://www.npmjs.com/package/swagger-ui-dist) javascript file and css file
-    1. swagger-ui-dist==4.13.2
+    1. swagger-ui-dist==4.14.0
 
 ## Usage
 

demo-mkdocs/docs/sample.png

@@ -10,6 +10,7 @@ theme:
   name: material
   features:
     - toc.integrate
+    - navigation.tabs
   palette:
     # Palette toggle for automatic mode
     - media: "(prefers-color-scheme)"
@@ -53,10 +54,11 @@ plugins:
 
 nav:
   - Home: index.md
-  - Pet Store: pet-store.md 
+  - Pet Store Example: pet-store.md 
   - Plugin Options: options.md
   - Demo: 
     - Static File: demo/static-file.md
+    - Full Width Swagger UI:  demo/pet-store-full-width.md
     - Multiple: demo/multiple.md
     - Build-in Multiple: demo/build-in-multiple.md
     - OAuth2 Initialization: demo/oauth2.md

demo-mkdocs/mkdocs.yml

@@ -88,6 +88,8 @@
 
 
 
+      
+    
     <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
     <label class="md-overlay" for="__drawer"></label>
@@ -187,6 +189,86 @@
 
 
 
+            <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
+  <div class="md-tabs__inner md-grid">
+    <ul class="md-tabs__list">
+      
+        
+
+
+
+
+  
+    <li class="md-tabs__item">
+      <a href="/mkdocs-swagger-ui-tag/." class="md-tabs__link">
+        
+  
+  Home
+
+      </a>
+    </li>
+  
+
+      
+        
+
+
+
+
+  
+    <li class="md-tabs__item">
+      <a href="/mkdocs-swagger-ui-tag/pet-store/" class="md-tabs__link">
+        
+  
+  Pet Store Example
+
+      </a>
+    </li>
+  
+
+      
+        
+
+
+
+
+  
+    <li class="md-tabs__item">
+      <a href="/mkdocs-swagger-ui-tag/options/" class="md-tabs__link">
+        
+  
+  Plugin Options
+
+      </a>
+    </li>
+  
+
+      
+        
+
+
+
+
+  
+    
+    
+    
+      <li class="md-tabs__item">
+        <a href="/mkdocs-swagger-ui-tag/demo/static-file/" class="md-tabs__link">
+          
+  
+  Demo
+
+        </a>
+      </li>
+    
+  
+
+      
+    </ul>
+  </div>
+</nav>
+          
 
 
       <main class="md-main" data-md-component="main">
@@ -199,10 +281,12 @@
                   <div class="md-sidebar__inner">
 
 
+  
+
 
 
 
-<nav class="md-nav md-nav--primary md-nav--integrated" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary md-nav--lifted md-nav--integrated" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="/mkdocs-swagger-ui-tag/." title="MkDocs Swagger UI Tag" class="md-nav__button md-logo" aria-label="MkDocs Swagger UI Tag" data-md-component="logo">
 
@@ -263,7 +347,7 @@
 
 
   <span class="md-ellipsis">
-    Pet Store
+    Pet Store Example
   </span>
 
       </a>
@@ -353,6 +437,25 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="/mkdocs-swagger-ui-tag/demo/pet-store-full-width/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Full Width Swagger UI
+  </span>
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
     <li class="md-nav__item">
       <a href="/mkdocs-swagger-ui-tag/demo/multiple/" class="md-nav__link">
 
@@ -456,7 +559,7 @@ <h1>404 - Not found</h1>
       <div class="md-dialog__inner md-typeset"></div>
     </div>
 
-    <script id="__config" type="application/json">{"base": "/mkdocs-swagger-ui-tag/", "features": ["toc.integrate"], "search": "/mkdocs-swagger-ui-tag/assets/javascripts/workers/search.720157f5.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.config.lang": "en", "search.config.pipeline": "stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version.title": "Select version"}}</script>
+    <script id="__config" type="application/json">{"base": "/mkdocs-swagger-ui-tag/", "features": ["toc.integrate", "navigation.tabs"], "search": "/mkdocs-swagger-ui-tag/assets/javascripts/workers/search.720157f5.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.config.lang": "en", "search.config.pipeline": "stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version.title": "Select version"}}</script>
 
 
       <script src="/mkdocs-swagger-ui-tag/assets/javascripts/bundle.15234abc.min.js"></script>