docs: Use doctools (#1258)

The extensions have been moved to docs tools.
The source code is available at
https://github.com/analogdevicesinc/doctools
And is installed as before:
(cd docs ; pip install -r requirements.txt --upgrade)
Since the package is listed on the requirements.txt file.

Also, add index for library and projects

Signed-off-by: Jorge Marques <[email protected]>

Author: gastmaier

README.md

@@ -47,9 +47,13 @@ This repository supports reference designs for different [Analog Devices boards]
 
 ### Building documentation
 
+Ensure pip is newer than version 23.
+```
+pip install pip --upgrade
+```
 Install the documentation tools.
 ```
-(cd docs ; pip install -r requirements.txt)
+(cd docs ; pip install -r requirements.txt --upgrade)
 ```
 Build the libraries (recommended).
 ```

docs/conf.py

@@ -1,33 +1,33 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
+# -- Project information ------------------------------------------------------
 
-# -- Project information -----------------------------------------------------
+repository = 'hdl'
+project = 'HDL'
+copyright = '2024, Analog Devices, Inc.'
+author = 'Analog Devices, Inc.'
 
-project = 'HDL, Analog Devices'
-copyright = '2023, Analog Devices Inc'
-author = 'Analog Devices Inc'
-release = 'v0.1'
-
-# -- General configuration ---------------------------------------------------
-
-import os, sys
-
-sys.path.append(os.path.abspath("./extensions"))
+# -- General configuration ----------------------------------------------------
 
 extensions = [
-	"sphinx.ext.todo",
-	"sphinx.ext.viewcode",
-	"sphinxcontrib.wavedrom",
-	"adi_links",
-	"adi_hdl_parser"
+    "sphinx.ext.todo",
+    "sphinx.ext.intersphinx",
+    "sphinxcontrib.wavedrom",
+    "adi_doctools"
 ]
 
-templates_path = ['sources/template']
+needs_extensions = {
+    'adi_doctools': '0.3'
+}
 
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+source_suffix = '.rst'
 
-# -- Custom extensions configuration -------------------------------------------
+# -- External docs configuration ----------------------------------------------
+
+intersphinx_mapping = {
+    'doctools': ('https://analogdevicesinc.github.io/doctools', None)
+}
+
+# -- Custom extensions configuration ------------------------------------------
 
 hide_collapsible_content = True
 validate_links = False
@@ -39,8 +39,7 @@
 
 # -- Options for HTML output --------------------------------------------------
 
-html_theme = 'furo'
+html_theme = 'cosmic'
 html_static_path = ['sources']
-source_suffix = '.rst'
 html_css_files = ["custom.css"]
 html_favicon = "sources/icon.svg"