User myst-nb for notebook rendering

.github/workflows/docs.yml

@@ -31,12 +31,13 @@ jobs:
         run: echo ::set-output name=tag::${GITHUB_REF#refs/*/}
       - name: env setup
         run: |
-          python -m pip install graphviz nbsite sphinx_holoviz_theme "nbconvert <=5.3.1"
+          python -m pip install graphviz myst_parser pydata-sphinx-theme "nbconvert <6.0" "myst-nb"
+          python -m pip install nbsite --pre
           python -m pip install -e .
       - name: build docs
         run: |
-          python -m nbsite generate-rst --org pyviz --repo param --project-name param
           mkdir doc/Reference_Manual && nbsite_generate_modules.py param -d ./doc/Reference_Manual -n param -e tests
+          cp examples/user_guide/*.ipynb doc/user_guide/
           python -m nbsite build --examples-assets='' --org holoviz --project-name param
       - name: Deploy dev
         uses: peaceiris/actions-gh-pages@v3

doc/conf.py

@@ -13,7 +13,7 @@
 param.parameterized.docstring_signature = False
 param.parameterized.docstring_describe_params = False
 
-extensions.append("myst_parser")
+extensions += ["myst_nb"]
 
 nbbuild_cell_timeout = 600
 

doc/user_guide/index.md

@@ -15,5 +15,6 @@ This user guide provides a detailed introduction to the API and features of Para
 ---
 hidden: true
 ---
+Overview <index>
 Simplifying Codebases <Simplifying_Codebases>
 ```

setup.py

@@ -27,7 +27,8 @@ def get_setup_version(reponame):
         'nbsite >=0.6.1',
         'pydata-sphinx-theme',
         'myst-parser',
-        'nbconvert <0.6'
+        'nbconvert <6.0',
+        'myst_nb'
     ]
 }