debugging bibtex

docs/requirements.txt

@@ -0,0 +1,15 @@
+#Python requirements file for building documentation
+# used by Read The Docs to install python required 
+# modules with pip.
+
+# Support Markdown
+#recommonmark
+
+#Handle references in bibtex format
+sphinxcontrib-bibtex
+
+#Work-around bug "AttributeError: 'Values' object has no attribute 'character_level_inline_markup'" with docutils 0.13.1
+#See:
+#  * https://github.com/sphinx-doc/sphinx/issues/3951
+#  * https://sourceforge.net/p/docutils/bugs/304/
+#docutils>=0.14

docs/source/conf.py

@@ -24,11 +24,11 @@ import sphinx_rtd_theme
 #html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # Import sphinxcontrib.bibtex
-#have_sphinxcontrib_bibtex = True
+have_sphinxcontrib_bibtex = True
-#try:
+try:
-#    import sphinxcontrib.bibtex
+    import sphinxcontrib.bibtex
-#except ImportError:
+except ImportError:
-#    have_sphinxcontrib_bibtex = False
+    have_sphinxcontrib_bibtex = False
 
 # -- Project information -----------------------------------------------------