DOC: updating tutorials

.github/workflows/auto_doc.yml

@@ -11,23 +11,30 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
         python-version: '3.11'
+
     - name: Install dependencies
       run: |
+        sudo apt-get update
+        sudo apt-get install -y pandoc
         python3 -m pip install --upgrade pip
         python3 -m pip install --upgrade -r ci_requirements_doc.txt
+
     - name: Install module
       run: |
         python3 -m pip install . 
+
     - name: Building documentation
       run: |
         cd doc
         make html
+
     - name: Deploying documentation
-      uses: JamesIves/github-pages-deploy-action@v4.3.3
+      uses: JamesIves/github-pages-deploy-action@v4
       with:
         branch: gh-pages # The branch the action should deploy to.
         folder: ./doc/build/html # The folder the action should deploy.

ci_requirements_doc.txt

@@ -3,3 +3,4 @@ numpy
 sphinx
 numpydoc
 pydata-sphinx-theme
+nbsphinx

doc/source/conf.py

@@ -37,6 +37,8 @@
     'sphinx.ext.autosummary',
     'numpydoc',
     'sphinx.ext.mathjax',
+    #'myst_nb',
+    'nbsphinx',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

doc/source/index.rst

@@ -37,6 +37,14 @@ Bibtex :
         title = {{Methods for analysis and design of composites (Version 0.7.1) [Computer software]. 2024}}
         }
 
+Tutorials
+---------
+
+.. toctree::
+    :maxdepth: 2
+
+    tutorials.rst
+
 
 composites API
 --------------

doc/source/tutorials.rst

@@ -0,0 +1,8 @@
+=========
+Tutorials
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    opt-lightweight-discrete-ghost-layer