feat(docs): upgrade mkdocs/mermaid

Author: noelmcloughlin

.github/workflows/codespell.yml

@@ -20,3 +20,6 @@ jobs:
         uses: actions/checkout@v3
       - name: Codespell
         uses: codespell-project/actions-codespell@v2
+        with:
+          skip: *.js
+

{{cookiecutter.project_name}}/mkdocs.yml

@@ -2,18 +2,37 @@
 site_name: "{{cookiecutter.project_name}}"
 theme:
   name: material
-  # palette:
-  #  scheme: slate
-  #  primary: cyan
+  palette:
+    # https://github.com/facelessuser/mkdocs_pymdownx_material_extras
+    scheme: dracula
+    primary: deep purple
+    accent: deep purple
   features:
     - content.tabs.link
+
 plugins:
   - search
-  - mermaid2
+  - mermaid2:
+      # https://mkdocs-mermaid2.readthedocs.io/en/latest/library
+      version: 10.9.0
+  - mkdocs_pymdownx_material_extras
+
+markdown_extensions:
+  - pymdownx.superfences:
+      # make exceptions to highlighting of code
+      custom_fences:
+        # activate display of Mermaid diagrams
+        - name: mermaid
+          class: mermaid
+          # https://pypi.org/project/mkdocs-pymdownx-material-extras
+          # https://mkdocs-mermaid2.readthedocs.io/en/latest/superfences
+          format: !!python/name:pymdownx.superfences.fence_code_format
+
 nav:
   # - Home: home.md
   - Index: index.md
   - About: about.md
+
 site_url: https://{{cookiecutter.github_org}}.github.io/{{cookiecutter.project_name}}
 repo_url: https://github.com/{{cookiecutter.github_org}}/{{cookiecutter.project_name}}
 

{{cookiecutter.project_name}}/pyproject.toml

@@ -18,13 +18,14 @@ style = "pep440"
 
 [tool.poetry.dev-dependencies]
 linkml = "^1.3.5"
-mkdocs-material = "^8.2.8"
-mkdocs-mermaid2-plugin = "^0.6.0"
+mkdocs-material = "^9.5.11"
+mkdocs-mermaid2-plugin = "^1.1.1"
+mkdocs-pymdownx-material-extras = "^2.5.6"
 schemasheets = "^0.1.14"
 
 [build-system]
 requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning"]
 build-backend = "poetry_dynamic_versioning.backend"
 
 [tool.poetry.extras]
-docs = ["linkml", "mkdocs-material"]
+docs = ["linkml", "mkdocs-material"]