fix: mermaid graphs on docs (#473)

* fix: mermaid graphs on docs

* publish docs for testing

* set mermaid version

* fix config

* downgrade mermaid2 plugin to 0.5.2

* native mermaid support

* go back to mermaid plugin

* add mermaid js lib

* fix mermaid

* add loader

* better loading

* remove loader

* remove doc deploy on PR

.github/workflows/mkdocs.yml

@@ -19,4 +19,5 @@ jobs:
           python-version: 3.x
       - run: pip install mkdocs-material
       - run: pip install mkdocs-render-swagger-plugin
+      - run: pip install mkdocs-mermaid2-plugin
       - run: mkdocs gh-deploy --force

mkdocs.yml

@@ -43,11 +43,18 @@ extra:
 
 plugins:
   - render_swagger
+  - search
+  - mermaid2
 
 # Extensions
 markdown_extensions:
   - pymdownx.highlight
-  - pymdownx.superfences
   - pymdownx.inlinehilite
+  - pymdownx.superfences:
+      # make exceptions to highlighting of code:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:mermaid2.fence_mermaid
 
 copyright: Copyright &copy; 2022 <a href="https://kubeshop.io">Kubeshop</a>