Merge remote-tracking branch 'origin/main' into autoscaling

Author: ianmkenney

devtools/conda-envs/docs.yml

@@ -5,7 +5,7 @@ channels:
 dependencies:
   - python<3.13
   - sphinx
-  - sphinx-rtd-theme
+  - furo
   - myst-nb
   - myst-parser>=0.14
   - docutils

docs/conf.py

@@ -12,7 +12,6 @@
 
 import sys
 import os
-import sphinx_rtd_theme
 
 sys.path.insert(0, os.path.abspath("."))
 
@@ -58,7 +57,12 @@
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = "sphinx_rtd_theme"
+html_theme = "furo"
+html_logo = "assets/logo/logo_full_horizontal_inverted.png"
+html_theme_options = {
+    "sidebar_hide_name": True,
+    "navigation_with_keys": True,
+}
 
 # -- Options for MystNB ------------------------------------------------------
 

docs/index.rst

@@ -44,10 +44,10 @@ and the :ref:`developer-guide` for details on how the components of this archite
 .. _OpenFreeEnergy: https://openfree.energy/
 
 .. toctree::
+   :hidden:
    :maxdepth: 1
    :caption: Contents:
 
-
    ./user_guide
    ./tutorials/index
    ./deployment
@@ -56,11 +56,3 @@ and the :ref:`developer-guide` for details on how the components of this archite
    ./development
    ./api
    CHANGELOG
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`