docs: Apply corporate design to repo-specific standalone docs (#3415)

.gitignore

@@ -51,6 +51,7 @@ dependencies.txt
 # exclude python virtual environments used for serving docs locally
 env/
 venv/
+.venv/
 
 # exclude generated openapi
 docs/03-endpoints/generated-openapi/*

docs/assets/css/theme.css

@@ -0,0 +1,28 @@
+[data-md-color-scheme="default"] {
+    --md-primary-fg-color: rgb(33, 68, 95);
+    --md-accent-fg-color: rgb(0, 94, 84);
+    /* --md-default-bg-color: rgb(235, 235, 235); */
+}
+
+[data-md-color-scheme="slate"] {
+    --md-primary-fg-color: rgb(116, 162, 207);
+    --md-accent-fg-color: rgb(0, 94, 84);
+    --md-default-bg-color: rgb(36, 37, 46);
+}
+
+.md-header,
+.md-tabs {
+    background-color: rgb(33, 68, 95) !important;
+}
+
+.md-content a {
+    text-decoration: underline;
+}
+
+h1,
+h2,
+h3,
+h4 {
+    font-weight: bold;
+    padding-top: 50px;
+}

docs/requirements.txt

@@ -1,8 +1,5 @@
 mkdocs
 mkdocs-material
-mkdocs-monorepo-plugin
-mkdocs-include-markdown-plugin
 mkdocs-git-revision-date-localized-plugin
-mike
 neoteroi-mkdocs
 

mkdocs.yml

@@ -105,17 +105,35 @@ nav:
   - Migration Guides and Deprecations: 10-migration-guides/index.md
 
 plugins:
-  - include-markdown
   - search
   - git-revision-date-localized
   - neoteroi.mkdocsoad:
       use_pymdownx: true
 
 theme:
   name: material
+  logo: "assets/icons/logo_bw.svg"
+  favicon: "assets/icons/logo_bw.svg"
+  palette:
+    - scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
   features:
-    - navigation.tabs
-    - navigation.sections
+    # - navigation.tabs
+    - navigation.instant
+    - navigation.tracking
+    - navigation.top
+    - search.suggest
+    - version
+
+extra_css:
+  - assets/css/theme.css
+  - assets/css/mkdocsoad-v1.0.2.css
 
 markdown_extensions:
   - admonition
@@ -130,6 +148,3 @@ markdown_extensions:
       custom_checkbox: true
   - pymdownx.tabbed:
       alternate_style: true
-
-extra_css:
-  - css/mkdocsoad-v1.0.2.css