]> gitweb.michael.orlitzky.com - dunshire.git/blobdiff - doc/source/conf.py
Update Sphinx with the new directory structure.
[dunshire.git] / doc / source / conf.py
index 673323100730a2185be349bda90b96759b8f03da..baf787e31df7d587fe990fb203b81f8777aba941 100644 (file)
@@ -7,22 +7,24 @@ import shlex
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('../../src/'))
-sys.path.insert(0, os.path.abspath('../../src/dunshire'))
+sys.path.insert(0, os.path.abspath('../../'))
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
-    'sphinx.ext.autosummary',
-    'sphinx.ext.coverage',
+    'sphinx.ext.doctest',
+    'sphinx.ext.mathjax',
     'sphinx.ext.napoleon',
-    'sphinx.ext.pngmath',
     'sphinx.ext.viewcode',
 ]
 
-autosummary_generate = True
+# Don't automatically test every >>> block in the documentation. This
+# avoids testing the API docs as part of the documentation build,
+# which is exactly what we intend, because those are tested as part of
+# the (much faster) unittest test suite.
+doctest_test_doctest_blocks = ''
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string: