add example from pymc_examples (#7)

* add example fron pymc_examples

* add example fron pymc_examples

* use wget instead of intersphinx

* avoid duplicating files

Author: aloctavodia

docs/conf.py

@@ -48,6 +48,19 @@
     "nbsphinx",
 ]
 
+external_docs = ["examples/BART_introduction.ipynb", "examples/references.bib"]
+for doc in external_docs:
+    if os.path.exists(doc):
+        os.remove(doc)
+
+os.system("wget https://raw.githubusercontent.com/pymc-devs/pymc-examples/main/examples/case_studies/BART_introduction.ipynb -P examples")
+os.system("wget https://raw.githubusercontent.com/pymc-devs/pymc-examples/main/examples/references.bib -P examples")
+
+# bibtex config
+bibtex_bibfiles = ["references.bib"]
+bibtex_default_style = "unsrt"
+bibtex_reference_style = "author_year"
+
 nbsphinx_execute = "never"
 
 # Add any paths that contain templates here, relative to this directory.
@@ -56,8 +69,7 @@
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-# source_suffix = ['.rst', '.md']
-source_suffix = ".rst"
+source_suffix = ['.rst', '.md']
 
 # The master toctree document.
 master_doc = "index"

docs/index.rst

@@ -80,8 +80,9 @@ Contents
 ========
 
 .. toctree::
-   :maxdepth: 4
+   :maxdepth: 2
 
+   examples/BART_introduction
    api_reference
 
 Indices