Switch docs to furo theme (#420)

* Switch docs to furo theme

* Added logo to sidebar, navigation with keys

* Removed indexes from top level page; moved toctree to contents.rst

Author: dotsdl

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,14 +12,15 @@
 
 import sys
 import os
-import sphinx_rtd_theme
 
 sys.path.insert(0, os.path.abspath("."))
 
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
+master_doc = "contents"
+
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
@@ -58,7 +59,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/contents.rst

@@ -0,0 +1,13 @@
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents:
+
+
+   ./user_guide
+   ./tutorials/index
+   ./deployment
+   ./compute
+   ./operations
+   ./development
+   ./api
+   CHANGELOG

docs/index.rst

@@ -42,25 +42,3 @@ and the :ref:`developer-guide` for details on how the components of this archite
 .. _Open Molecular Software Foundation: https://omsf.io
 .. _OpenForceField: https://openforcefield.org
 .. _OpenFreeEnergy: https://openfree.energy/
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Contents:
-
-
-   ./user_guide
-   ./tutorials/index
-   ./deployment
-   ./compute
-   ./operations
-   ./development
-   ./api
-   CHANGELOG
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`