docs: Use adi-doctools

1. Add extension and theme in conf.py
2. Add doc build products to gitignore
3. Add requirements file

Signed-off-by: RibhuDP <[email protected]>

.github/workflows/doc.yml

@@ -17,10 +17,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          sudo apt install -y python3-numpy
-          pip install -r requirements_doc.txt
-          python -m pip install sphinx-toolbox
-          pip install sphinx myst_parser
+          pip install -r docs/source/requirements_doc.txt
           sudo apt-get install doxygen graphviz -y
               
       - name: Check doc build

.gitignore

@@ -1 +1,2 @@
-.github/CODEOWNERS
+.github/CODEOWNERS
+docs/build/

docs/source/conf.py

@@ -6,9 +6,9 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = 'Precision Toolbox for MATLAB'
-copyright = '2023, Analog Devices Inc.'
-author = 'Analog Devices Inc.'
+repository = 'PrecisionToolbox'
+project = 'Precision Toolbox'
+copyright = '2023-2024, Analog Devices Inc.'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -28,18 +28,17 @@
 
 
 extensions = [
-    'sphinx_toolbox.collapse'
+    'adi_doctools'
     ]
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
 
-
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = "bizstyle"
-html_static_path = ['_static']
+html_theme = "cosmic"
+html_static_path = []
 
-html_logo = "adi_logo.png"
+#html_logo = "adi_logo.png"

docs/source/requirements.txt

@@ -0,0 +1,3 @@
+sphinx
+myst_parser
+https://github.com/analogdevicesinc/doctools/releases/download/latest/adi-doctools.tar.gz