From 30ae1e452f670e0b07540805b301ca0dc4125834 Mon Sep 17 00:00:00 2001
From: Paolo Melchiorre <paolo@melchiorre.org>
Date: Sun, 12 Nov 2023 18:16:20 +0100
Subject: [PATCH] Fix # 1412 -- Use Material for MkDocs

---
 docs/python.svg |  1 +
 mkdocs.yml      | 36 ++++++++++++++++++++++++++++++++++--
 pyproject.toml  |  2 +-
 3 files changed, 36 insertions(+), 3 deletions(-)
 create mode 100644 docs/python.svg

diff --git a/docs/python.svg b/docs/python.svg
new file mode 100644
index 00000000..e6ffbf0a
--- /dev/null
+++ b/docs/python.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" version="1.0"><defs><linearGradient id="b" x1="151" x2="112" y1="192.3" y2="137.3" gradientTransform="matrix(.56254 0 0 .56797 -15 -11.7)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#ffd43b"/><stop offset="1" stop-color="#ffe873"/></linearGradient><linearGradient id="a" x1="26.6" x2="135.7" y1="20.6" y2="114.4" gradientTransform="matrix(.56254 0 0 .56797 -15 -11.7)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#5a9fd4"/><stop offset="1" stop-color="#306998"/></linearGradient></defs><path fill="url(#a)" d="M55 0c-4.8 0-9 .4-13 1-11.2 2.2-13.3 6.4-13.3 14v10.3h26.8v3.4H18.6C10.8 28.7 4 33.3 2 42.3a50.1 50.1 0 0 0 0 27.2c1.9 8 6.4 13.6 14.2 13.6h9.3V70.8A17 17 0 0 1 42 54.2h27c7.4 0 13.4-6.1 13.4-13.6V15c0-7.2-6.1-12.7-13.4-13.9C64.3.3 59.5 0 54.9 0zM40.3 8.2a5 5 0 0 1 5 5.1 5 5 0 0 1-5 5.1 5 5 0 0 1-5-5 5 5 0 0 1 5-5.2z" transform="translate(.2) scale(.28473)"/><path fill="url(#b)" d="M85.6 28.7v11.9c0 9.2-7.8 17-16.7 17H42c-7.3 0-13.4 6.2-13.4 13.6v25.5c0 7.3 6.3 11.6 13.4 13.6 8.5 2.5 16.6 3 26.8 0 6.7-2 13.4-5.8 13.4-13.6V86.5H55.5v-3.4h40.2c7.8 0 10.7-5.4 13.4-13.6a46 46 0 0 0 0-27.3c-2-7.7-5.6-13.5-13.4-13.5zm-15 64.6a5 5 0 0 1 5 5.1 5 5 0 0 1-5 5.1 5 5 0 0 1-5-5 5 5 0 0 1 5-5.2z" transform="translate(.2) scale(.28473)"/></svg>
diff --git a/mkdocs.yml b/mkdocs.yml
index fd2e407c..b21792f3 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -8,10 +8,42 @@ use_directory_urls: true
 watch: [markdown, scripts]
 
 theme:
-  name: nature
-  icon: py.png
+  name: material
+  icon:
+    previous: fontawesome/solid/angle-left
+    next: fontawesome/solid/angle-right
+  logo: python.svg
+  favicon: favicon.ico
   release: !!python/name:markdown.__version__
+  repo_url: https://github.com/Python-Markdown/markdown
+  repo_name: Python-Markdown/markdown
   issue_tracker: https://github.com/Python-Markdown/markdown/issues
+  icon:
+    repo: fontawesome/brands/git-alt
+  features:
+    - navigation.footer
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: green
+      toggle:
+        icon: material/weather-night
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: green
+      toggle:
+        icon: material/weather-sunny
+        name: Switch to light mode
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/Python-Markdown/markdown
+      name: GitHub
+    - icon: fontawesome/brands/python
+      link: https://pypi.org/project/Markdown/
+      name: PyPI
 
 extra_css:
   - custom.css
diff --git a/pyproject.toml b/pyproject.toml
index 8c9e9bcf..5d83c97a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -54,7 +54,7 @@ testing = [
 ]
 docs = [
     'mkdocs>=1.5',
-    'mkdocs-nature>=0.6',
+    'mkdocs-material>=9.0',
     'mdx_gh_links>=0.2',
     "mkdocstrings[python]",
     "mkdocs-gen-files",