DOC: Add sphinxcontrib-bibtex dependency

Author: mgeier

.travis.yml

@@ -28,6 +28,7 @@ install:
   - pip install .
   - pip install ipykernel
   - pip install matplotlib
+  - pip install sphinxcontrib-bibtex
 script:
   - python -m sphinx doc/ doc/_build/ -b html
   - python -m sphinx doc/ doc/_build/ -b latex

doc/conf.py

@@ -4,10 +4,11 @@
 # Use sphinx-quickstart to create your own conf.py file!
 # After that, you have to edit a few things.  See below.
 
-# Select nbsphinx and, if needed, add a math extension (mathjax or imgmath):
+# Select nbsphinx and, if needed, other Sphinx extensions:
 extensions = [
     'nbsphinx',
     'sphinx.ext.mathjax',
+    'sphinxcontrib.bibtex',
 ]
 
 # Exclude build directory and Jupyter backup files:
@@ -99,6 +100,9 @@
     'TeX': {'equationNumbers': {'autoNumber': 'AMS', 'useLabelIds': True}},
 }
 
+# TODO: explain!
+latex_additional_files = ['references.bib']
+
 # -- The settings below this line are not specific to nbsphinx ------------
 
 master_doc = 'index'

doc/readthedocs-environment.yml

@@ -7,3 +7,4 @@ dependencies:
   - nbconvert!=5.4
   - ipykernel
   - matplotlib
+  - sphinxcontrib-bibtex

doc/requirements.txt

@@ -2,3 +2,4 @@ sphinx>=1.6
 nbconvert!=5.4
 ipykernel
 matplotlib
+sphinxcontrib-bibtex