get bibtex references working

Author: drbenvincent

.pre-commit-config.yaml

@@ -36,7 +36,7 @@ repos:
     - repo: https://github.com/econchick/interrogate
       rev: 1.5.0
       hooks:
-          - id: interrogate
-            # needed to make excludes in pyproject.toml work
-            # see here https://github.com/econchick/interrogate/issues/60#issuecomment-735436566
-            pass_filenames: false
+        - id: interrogate
+          # needed to make excludes in pyproject.toml work
+          # see here https://github.com/econchick/interrogate/issues/60#issuecomment-735436566
+          pass_filenames: false

docs/source/_static/interrogate_badge.svg

@@ -46,31 +46,36 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
-    "myst_parser",
-    "nbsphinx",
+    "myst_nb",
+    "sphinxcontrib.bibtex",
     "sphinx.ext.autodoc",
     "sphinx.ext.intersphinx",
     "sphinx.ext.mathjax",
     "sphinx_autodoc_typehints",
 ]
 
-source_suffix = [".rst", ".md"]
+nb_execution_mode = "off"
+
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".ipynb": "myst-nb",
+    ".myst": "myst-nb",
+}
 templates_path = ["_templates"]
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 master_doc = "index"
 
+# bibtex config
+bibtex_bibfiles = ["references.bib"]
+bibtex_default_style = "unsrt"
+bibtex_reference_style = "author_year"
+
 # -- intersphinx config -------------------------------------------------------
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
     "pymc": ("https://www.pymc.io/projects/docs/en/stable/", None),
 }
 
-# -- nbsphinx config ----------------------------------------------------------
-# Opt out of executing the notebooks remotely. This will save time in the remote build
-# process on readthedocs. The notebooks in /docs/notebooks will be parsed/converted,
-# but not re-executed.
-nbsphinx_execute = "never"
-
 # MyST options for working with markdown files.
 # Info about extensions here https://myst-parser.readthedocs.io/en/latest/syntax/optional.html?highlight=math#admonition-directives # noqa: E501
 myst_enable_extensions = [

docs/source/conf.py

@@ -1,10 +1,8 @@
 # Glossary
 
-<div class="admonition note" name="html-admonition">
-<p class="title">Note:</p>
-Some of the definitions have been copied from (or inspired by) various resources, including Reichardt (2019).
-</div>
-
+:::{note}
+Some of the definitions have been copied from (or inspired by) various resources, including {cite:t}`reichardt2019quasi`.
+:::
 
 **ANCOVA:** Analysis of covariance is a simple linear model, typically with one continuous predictor (the covariate) and a catgeorical variable (which may correspond to treatment or control group). In the context of this package, ANCOVA could be useful in pre-post treatment designs, either with or without random assignment. This is similar to the approach of difference in differences, but only applicable with a single pre and post treatment measure.
 
@@ -63,4 +61,6 @@ Data from pretest-posttest NEGD could be analysed using change score analysis or
 **Treatment effect:** The difference in outcomes between what happened after a treatment is implemented and what would have happened (see Counterfactual) if the treatment had not been implemented, assuming everything else had been the same.
 
 ## References
-* Reichardt, C. S. (2019). Quasi-experimentation: A guide to design and analysis. Guilford Publications.
+:::{bibliography}
+:filter: docname in docnames
+:::

docs/source/glossary.md

@@ -7,13 +7,9 @@
    "source": [
     "# ANCOVA for pre/post treatment nonequivalent group designs\n",
     "\n",
-    "<div class=\"alert alert-warning\">\n",
-    "\n",
-    "Warning\n",
-    "\n",
+    ":::{note}\n",
     "This is a preliminary example based on synthetic data. It will hopefully soon be updated with data from a real study.\n",
-    "\n",
-    "</div>\n",
+    ":::\n",
     "\n",
     "In cases where there is just one pre and one post treatment measurement, it we can analyse data from NEGD experiments using an ANCOVA type approach. The basic model is:\n",
     "\n",
@@ -56,6 +52,7 @@
    ]
   },
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [
@@ -219,13 +216,9 @@
    "source": [
     "## Run the analysis\n",
     "\n",
-    "<div class=\"alert alert-info\">\n",
-    "\n",
-    "Note:\n",
-    "\n",
+    ":::{note}\n",
     "The `random_seed` keyword argument for the PyMC sampler is not neccessary. We use it here so that the results are reproducible.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {

docs/source/notebooks/ancova_pymc.ipynb

@@ -7,13 +7,9 @@
    "source": [
     "# Difference in Differences with `pymc` models\n",
     "\n",
-    "<div class=\"alert alert-warning\">\n",
-    "\n",
-    "Warning\n",
-    "\n",
+    ":::{note}\n",
     "This example is in-progress! Further elaboration and explanation will follow soon.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {
@@ -40,6 +36,7 @@
    ]
   },
   {
+   "attachments": {},
    "cell_type": "markdown",
    "metadata": {},
    "source": [

docs/source/notebooks/did_pymc.ipynb

@@ -7,13 +7,9 @@
    "source": [
     "# Banking dataset with a `pymc` model\n",
     "\n",
-    "<div class=\"alert alert-warning\">\n",
-    "\n",
-    "Warning\n",
-    "\n",
+    ":::{note}\n",
     "This example is in-progress! Further elaboration and explanation will follow soon.\n",
-    "\n",
-    "</div>\n",
+    ":::\n",
     "\n",
     "This notebook analyses historic data on banking closures from [Richardson & Troost (2009)](http://masteringmetrics.com/wp-content/uploads/2015/02/Richardson_Troost_2009_JPE.pdf) and used as a case study for a difference in differences analysis in the [Mastering Metrics](http://www.masteringmetrics.com) book. Here, we replicate this analysis, but using Bayesian inference."
    ]
@@ -395,13 +391,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<div class=\"alert alert-info\">\n",
-    "\n",
-    "Note:\n",
-    "\n",
+    ":::{note}\n",
     "The `random_seed` keyword argument for the PyMC sampler is not neccessary. We use it here so that the results are reproducible.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {

docs/source/notebooks/did_pymc_banks.ipynb

@@ -268,13 +268,9 @@
     "\n",
     "We can use `CausalPy`'s API to run this procedure, but using Bayesian inference methods as follows:\n",
     "\n",
-    "<div class=\"alert alert-info\">\n",
-    "\n",
-    "Note:\n",
-    "\n",
+    ":::{note}\n",
     "The `random_seed` keyword argument for the PyMC sampler is not neccessary. We use it here so that the results are reproducible.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {

docs/source/notebooks/geolift1.ipynb

@@ -181,13 +181,9 @@
     "\n",
     "In this example we are going to standardize the data. So we have to be careful in how we interpret the inferred regression coefficients, and the posterior predictions will be in this standardized space.\n",
     "\n",
-    "<div class=\"alert alert-info\">\n",
-    "\n",
-    "Note:\n",
-    "\n",
+    ":::{note}\n",
     "The `random_seed` keyword argument for the PyMC sampler is not neccessary. We use it here so that the results are reproducible.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {

docs/source/notebooks/its_covid.ipynb

@@ -162,13 +162,9 @@
    "source": [
     "Run the analysis\n",
     "\n",
-    "<div class=\"alert alert-info\">\n",
-    "\n",
-    "Note:\n",
-    "\n",
+    ":::{note}\n",
     "The `random_seed` keyword argument for the PyMC sampler is not neccessary. We use it here so that the results are reproducible.\n",
-    "\n",
-    "</div>"
+    ":::"
    ]
   },
   {