From 17a6f853f9cc139f51143b2d8eed4911b637fb6e Mon Sep 17 00:00:00 2001
From: Arnau Casau <47946624+arnaucasau@users.noreply.github.com>
Date: Mon, 16 Oct 2023 22:15:28 +0200
Subject: [PATCH] Update Sphinx theme (#693)

* Update Sphinx theme

Co-authored-by: Frank Harkins <36071638+frankharkins@users.noreply.github.com>

* Fix docs heading levels

---------

Co-authored-by: Frank Harkins <36071638+frankharkins@users.noreply.github.com>
Co-authored-by: Steve Wood <40241007+woodsp-ibm@users.noreply.github.com>
---
 docs/conf.py                                      | 15 ++-------------
 qiskit_machine_learning/algorithms/__init__.py    |  6 +++---
 .../circuit/library/__init__.py                   |  4 ++--
 qiskit_machine_learning/connectors/__init__.py    |  2 +-
 qiskit_machine_learning/datasets/__init__.py      |  2 +-
 qiskit_machine_learning/kernels/__init__.py       |  4 ++--
 .../neural_networks/__init__.py                   |  6 +++---
 qiskit_machine_learning/utils/__init__.py         |  2 +-
 .../utils/loss_functions/__init__.py              |  4 ++--
 requirements-dev.txt                              |  2 +-
 10 files changed, 18 insertions(+), 29 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index eea1ae451..00266a300 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -177,19 +177,8 @@
 
 # -- Options for HTML output -------------------------------------------------
 
-html_theme = "qiskit_sphinx_theme"
-html_theme_options = {
-    "logo_only": False,
-    "display_version": True,
-    "prev_next_buttons_location": "bottom",
-    "style_external_links": False,
-    # Toc options
-    "collapse_navigation": True,
-    "sticky_navigation": True,
-    "navigation_depth": 4,
-    "includehidden": True,
-    "titles_only": False,
-}
+html_theme = "qiskit-ecosystem"
+html_title = f"{project} {release}"
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
diff --git a/qiskit_machine_learning/algorithms/__init__.py b/qiskit_machine_learning/algorithms/__init__.py
index f6a5d49ea..1c356f1ca 100644
--- a/qiskit_machine_learning/algorithms/__init__.py
+++ b/qiskit_machine_learning/algorithms/__init__.py
@@ -19,7 +19,7 @@
 .. currentmodule:: qiskit_machine_learning.algorithms
 
 Machine Learning Base Classes
-=============================
+-----------------------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -30,7 +30,7 @@
    SerializableModelMixin
 
 Machine Learning Objective Functions
-====================================
+------------------------------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -41,7 +41,7 @@
    OneHotObjectiveFunction
 
 Algorithms
-==========
+----------
 
 Classifiers
 +++++++++++
diff --git a/qiskit_machine_learning/circuit/library/__init__.py b/qiskit_machine_learning/circuit/library/__init__.py
index 5f7969576..4ddaf09e0 100644
--- a/qiskit_machine_learning/circuit/library/__init__.py
+++ b/qiskit_machine_learning/circuit/library/__init__.py
@@ -20,7 +20,7 @@
 .. currentmodule:: qiskit_machine_learning.circuit.library
 
 Feature Maps
-============
+------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -30,7 +30,7 @@
    RawFeatureVector
 
 Helper Circuits
-===============
+---------------
 
 .. autosummary::
    :toctree: ../stubs/
diff --git a/qiskit_machine_learning/connectors/__init__.py b/qiskit_machine_learning/connectors/__init__.py
index aebe0b55d..84f539f30 100644
--- a/qiskit_machine_learning/connectors/__init__.py
+++ b/qiskit_machine_learning/connectors/__init__.py
@@ -19,7 +19,7 @@
 .. currentmodule:: qiskit_machine_learning.connectors
 
 Connectors
-======================
+----------------------
 
 .. autosummary::
    :toctree: ../stubs/
diff --git a/qiskit_machine_learning/datasets/__init__.py b/qiskit_machine_learning/datasets/__init__.py
index ae17cd72c..e4d4f1711 100644
--- a/qiskit_machine_learning/datasets/__init__.py
+++ b/qiskit_machine_learning/datasets/__init__.py
@@ -19,7 +19,7 @@
 .. currentmodule:: qiskit_machine_learning.datasets
 
 Datasets
-========
+--------
 
 .. autosummary::
    :toctree: ../stubs/
diff --git a/qiskit_machine_learning/kernels/__init__.py b/qiskit_machine_learning/kernels/__init__.py
index 8c2980d1c..3852868f6 100644
--- a/qiskit_machine_learning/kernels/__init__.py
+++ b/qiskit_machine_learning/kernels/__init__.py
@@ -36,7 +36,7 @@
 .. currentmodule:: qiskit_machine_learning.kernels
 
 Quantum Kernels
-===============
+---------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -50,7 +50,7 @@
    TrainableFidelityStatevectorKernel
 
 Submodules
-==========
+----------
 
 .. autosummary::
    :toctree:
diff --git a/qiskit_machine_learning/neural_networks/__init__.py b/qiskit_machine_learning/neural_networks/__init__.py
index fe7a3b9dc..288a49162 100644
--- a/qiskit_machine_learning/neural_networks/__init__.py
+++ b/qiskit_machine_learning/neural_networks/__init__.py
@@ -28,7 +28,7 @@
 .. currentmodule:: qiskit_machine_learning.neural_networks
 
 Neural Network Base Classes
-===========================
+---------------------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -37,7 +37,7 @@
    NeuralNetwork
 
 Neural Networks
-===============
+---------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -47,7 +47,7 @@
    SamplerQNN
 
 Neural Network Metrics
-======================
+----------------------
 
 .. autosummary::
    :toctree: ../stubs/
diff --git a/qiskit_machine_learning/utils/__init__.py b/qiskit_machine_learning/utils/__init__.py
index aaa12e291..bba7f030a 100644
--- a/qiskit_machine_learning/utils/__init__.py
+++ b/qiskit_machine_learning/utils/__init__.py
@@ -19,7 +19,7 @@
 .. currentmodule:: qiskit_machine_learning.utils
 
 Utilities
-==========
+----------
 
 .. autosummary::
    :toctree:
diff --git a/qiskit_machine_learning/utils/loss_functions/__init__.py b/qiskit_machine_learning/utils/loss_functions/__init__.py
index bcc8cdce4..04b98f870 100644
--- a/qiskit_machine_learning/utils/loss_functions/__init__.py
+++ b/qiskit_machine_learning/utils/loss_functions/__init__.py
@@ -20,7 +20,7 @@
 .. currentmodule:: qiskit_machine_learning.utils.loss_functions
 
 Loss Function Base Class
-========================
+------------------------
 
 .. autosummary::
    :toctree: ../stubs/
@@ -30,7 +30,7 @@
    KernelLoss
 
 Loss Functions
-==============
+--------------
 
 .. autosummary::
    :toctree: ../stubs/
diff --git a/requirements-dev.txt b/requirements-dev.txt
index a91e08d49..6d7241584 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -16,4 +16,4 @@ qiskit-aer>=0.11.2
 mypy>=0.981
 mypy-extensions>=0.4.3
 nbsphinx
-qiskit_sphinx_theme~=1.12.0
+qiskit_sphinx_theme~=1.16.0