Update git submodules
[docs.git] / docs / conf.py
index 05e6948fe2b1ba26ed7c38698448b6e3bdb541db..41474107bb9e1527f6664a577ee0e65805670209 100644 (file)
@@ -20,7 +20,7 @@ import sphinx_bootstrap_theme
 # 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('.'))
+sys.path.insert(0, os.path.abspath('submodules/spectrometer/server'))
 
 # -- General configuration ------------------------------------------------
 
@@ -30,17 +30,7 @@ import sphinx_bootstrap_theme
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = []
-
-# Disable javasphinx generation until we have a solution to long build
-# times. readthedocs timesout after 902 seconds.
-javasphinx_available = False
-try:
-    import javasphinx
-    javasphinx_available = True
-    extensions.append('javasphinx')
-except ImportError, e:
-    pass
+extensions = ['sphinx.ext.autodoc','sphinx.ext.graphviz']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -128,6 +118,8 @@ html_theme = 'bootstrap'
 #html_theme_options = {}
 html_theme_options = {
     'bootswatch_theme': "united",
+    'navbar_sidebarrel': False,
+    'source_link_position': "footer",
 }
 
 # Add any paths that contain custom themes here, relative to this directory.
@@ -170,7 +162,9 @@ html_static_path = ['_static']
 #html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
+html_sidebars = {
+    '**': ['localtoc.html', 'relations.html'],
+}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
@@ -217,6 +211,10 @@ html_static_path = ['_static']
 # implements a search results scorer. If empty, the default will be used.
 #html_search_scorer = 'scorer.js'
 
+html_context = {
+    'version_status': 'unsupported',
+}
+
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'OpenDaylightDocumentationdoc'
 
@@ -311,6 +309,8 @@ linkcheck_ignore = [
     'https://git.opendaylight.org/gerrit/#/admin/projects/releng/builder',
 ]
 
+nitpicky = True
+
 import platform
 if platform.system() != 'Windows':
 
@@ -318,9 +318,3 @@ if platform.system() != 'Windows':
     import subprocess
 
     subprocess.call(["./build-integration-robot-libdoc.sh"])
-
-    # Disable javasphinx generation until we have a solution to long build
-    # times. readthedocs timesout after 902 seconds.
-    if javasphinx_available:
-        subprocess.call(["./generate-javaapidoc.sh"])
-