Use neoteroi-mkdocs instead

- seems to render more reliably

docs/docs/api/api.md

@@ -17,6 +17,9 @@ The API is self-documenting, and the documentation is provided alongside any Inv
 {% include 'img.html' %}
 {% endwith %}
 
+!!! info "Schema Description"
+    The API schema is also documented in the [API Schema](./schema.md) page.
+
 ## Authentication
 
 Users must be authenticated to gain access to the InvenTree API. The API accepts either basic username:password authentication, or token authentication. Token authentication is recommended as it provides much faster API access.

docs/docs/api/schema.md

@@ -4,6 +4,10 @@ title: API Schema
 
 The InvenTree API is implemented using the [Django REST framework](https://www.django-rest-framework.org). The API schema as documented below is generated using the [drf-spectactular](https://github.com/tfranzel/drf-spectacular/) extensions.
 
-## Schama
+## Schema File
 
-!!swagger api.yaml!!
+-- TODO -- download
+
+## Schama Spcecification
+
+[OAD(./docs/api.yml)]

docs/mkdocs.yml

@@ -55,6 +55,7 @@ extra_css:
   - stylesheets/bootstrap.css
   - stylesheets/splide.min.css
   - stylesheets/extra.css
+  - stylesheets/neoteroi-mkdocs.css
 extra_javascript:
   - javascripts/extra.js
   - javascripts/fontawesome.js
@@ -223,7 +224,8 @@ nav:
 
 # Plugins
 plugins:
-  - render_swagger
+  - neoteroi.mkdocsoad:
+      use_pymdownx: true
   - include-markdown:
       opening_tag: "{!"
       closing_tag: "!}"
@@ -242,6 +244,8 @@ markdown_extensions:
   - meta
   - pymdownx.details
   - pymdownx.highlight
+  - pymdownx.tabbed:
+      alternate_style: true
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid

docs/requirements.txt

@@ -4,4 +4,4 @@ mkdocs-material>=9.0,<10.0
 mkdocs-git-revision-date-localized-plugin>=1.1,<2.0
 mkdocs-simple-hooks>=0.1,<1.0
 mkdocs-include-markdown-plugin
-mkdocs-render-swagger-plugin
+neoteroi-mkdocs