X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2Fconf.py;h=5ac0a5116a02d3981ce977d23289097c81737814;hb=a100c8cf4a6aa6f75c949319581ac23762393cb7;hp=0dfb669b4c0ce3102fe48043a6ede09e293474cb;hpb=ddd41c391fc21df2dd166683f81f82cca28f19b8;p=docs.git diff --git a/docs/conf.py b/docs/conf.py index 0dfb669b4..5ac0a5116 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -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,17 @@ 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 = [] +extensions = ['sphinx.ext.autodoc'] # 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 +javasphinx_available = False +try: + import javasphinx + javasphinx_available = True + extensions.append('javasphinx') +except ImportError, e: + pass # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -148,7 +148,7 @@ html_logo = '_static/odl_small.png' # The name of an image file (relative to this directory) to use as a favicon of # the docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. -#html_favicon = None +html_favicon = 'favicon.ico' # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, @@ -311,13 +311,16 @@ linkcheck_ignore = [ 'https://git.opendaylight.org/gerrit/#/admin/projects/releng/builder', ] -# Build integration stuff -import subprocess +import platform +if platform.system() != 'Windows': -subprocess.call(["./build-integration-robot-libdoc.sh"]) + # Build integration stuff + 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"]) -# Disable javasphinx generation until we have a solution to long build -# times. readthedocs timesout after 902 seconds. -subprocess.call(["rm","-rf","javadoc"]) -# if javasphinx_available: -# subprocess.call(["./generate-javaapidoc.sh"])