Update dependencies for Sphinx 8

Major dependency updates:
- sphinx
- sphinx_rtd_theme
- myst-parser
- mdformat-frontmatter

Minor dependency updates:
- sphinx-copybutton
- sphinx-notfound-page
- sphinx-sitemap
- frontmatter
- mdformat
- mdformat-myst
- GitPython
- ruamel.yaml

Author: tdgroot

docs/_static/css/main.css

@@ -470,7 +470,7 @@
         grid-area: 1 / span 1;
     }
 }
-.wy-side-nav-search>a {
+.wy-side-nav-search>a.icon {
     display: flex;
     margin-bottom: 0;
     font-size: 15px;

docs/_static/scss/components/_layout.scss

@@ -28,23 +28,22 @@
   {%- endblock -%}
 
   {#- CSS #}
-  {%- if sphinx_version_info < (4, 0) -%}
-    <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
-    <link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
-  {%- endif %}
-  {%- if theme_analytics_id %}
-    <link rel="stylesheet" href="{{ pathto('_static/cookieconsent.css', 1) }}" type="text/css" />
-  {%- endif %}
-  {%- for css in css_files %}
-    {%- if css|attr("rel") %}
-      <link rel="{{ css.rel }}" href="{{ pathto(css.filename, 1) }}" type="text/css"{% if css.title is not none %} title="{{ css.title }}"{% endif %} />
+  {%- for css_file in css_files %}
+    {%- if css_file|attr("filename") %}
+      {{ css_tag(css_file) }}
     {%- else %}
-      <link rel="stylesheet" href="{{ pathto(css, 1) }}" type="text/css" />
+      <link rel="stylesheet" href="{{ pathto(css_file, 1)|escape }}" type="text/css" />
     {%- endif %}
   {%- endfor %}
 
-  {%- for cssfile in extra_css_files %}
-    <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
+  {#
+      "extra_css_files" is an undocumented Read the Docs theme specific option.
+      There is no need to check for ``|attr("filename")`` here because it's always a string.
+      Note that this option should be removed in favor of regular ``html_css_files``:
+      https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_css_files
+  #}
+  {%- for css_file in extra_css_files %}
+    <link rel="stylesheet" href="{{ pathto(css_file, 1)|escape }}" type="text/css" />
   {%- endfor -%}
 
   {#- FAVICON #}

docs/_templates/layout.html

@@ -114,6 +114,6 @@
     "php": {"startinline": True},  # We often have php snippets without the <?php tag
 }
 
-notfound_no_urls_prefix = True
+notfound_urls_prefix = None
 
 myst_heading_anchors = 5

docs/conf.py

@@ -1,20 +1,20 @@
 # docs/ requirements
-sphinx==5.3.0
-sphinx_rtd_theme==1.1.1
-myst-parser==0.18.1
+sphinx==8.2.3
+sphinx_rtd_theme==3.0.2
+myst-parser==4.0.1
 mdit-py-plugins
-sphinx-copybutton==0.5.1
-mdformat==0.7.16
-mdformat-myst==0.1.5
-mdformat-frontmatter==0.4.1
-sphinx-notfound-page==0.8.3
-sphinx-sitemap==2.4.0
-GitPython==3.1.30
-ruamel.yaml==0.18.12
+sphinx-copybutton==0.5.2
+mdformat==0.7.22
+mdformat-myst==0.2.1
+mdformat-frontmatter==2.0.8
+sphinx-notfound-page==1.1.0
+sphinx-sitemap==2.8.0
+GitPython==3.1.45
+ruamel.yaml==0.18.15
 
 # hypernode/ requirements
 beautifulsoup4==4.11.1
 markdownify==0.11.2
 python-slugify==6.1.2
 pyyaml==5.1
-frontmatter==3.0.7
+frontmatter==3.0.8