Uniformize HACF docs & move theme to Furo

.readthedocs.yml

@@ -1,6 +1,4 @@
 version: 2
-sphinx:
-  configuration: docs/conf.py
 formats: all
 python:
   install:
@@ -10,3 +8,5 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.11"
+sphinx:
+  configuration: docs/conf.py

docs/conf.py

@@ -2,8 +2,12 @@
 from datetime import datetime
 
 
-project = "freebox-api"
-author = "HACF"
+project = "Freebox API"
+author = "HACF (created by @fstercq, maintained by @Quentame)"
 copyright = f"{datetime.now().year}, {author}"
-extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon"]
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+]
 autodoc_typehints = "description"
+html_theme = "furo"

docs/requirements.txt

@@ -1,2 +1,2 @@
 sphinx==7.2.6
-sphinx-rtd-theme==1.3.0
+furo==2023.9.10

noxfile.py

@@ -9,14 +9,14 @@
 try:
     from nox_poetry import Session
     from nox_poetry import session
-except ImportError:
+except ImportError as err:
     message = f"""\
     Nox failed to import the 'nox-poetry' package.
 
     Please install it using the following command:
 
     {sys.executable} -m pip install nox-poetry"""
-    raise SystemExit(dedent(message)) from None
+    raise SystemExit(dedent(message)) from err
 
 
 package = "freebox_api"
@@ -172,7 +172,7 @@ def docs_build(session: Session) -> None:
     """Build the documentation."""
     args = session.posargs or ["docs", "docs/_build"]
     session.install(".")
-    session.install("sphinx", "sphinx-click", "sphinx-rtd-theme")
+    session.install("sphinx", "sphinx-click", "furo")
 
     build_dir = Path("docs", "_build")
     if build_dir.exists():
@@ -186,7 +186,7 @@ def docs(session: Session) -> None:
     """Build and serve the documentation with live reloading on file changes."""
     args = session.posargs or ["--open-browser", "docs", "docs/_build"]
     session.install(".")
-    session.install("sphinx", "sphinx-autobuild", "sphinx-click", "sphinx-rtd-theme")
+    session.install("sphinx", "sphinx-autobuild", "sphinx-click", "furo")
 
     build_dir = Path("docs", "_build")
     if build_dir.exists():