X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/ec96922670ac3b803120a489b18c3b2c769ac087..d3c1a287e32a22288af6e167f4f3ad8aa7a2e86c:/docs/source/conf.py diff --git a/docs/source/conf.py b/docs/source/conf.py index 74a792865d..dce6685743 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -12,33 +12,33 @@ # 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. # -import os, subprocess +import os +import subprocess # Search for our extensions too import sys sys.path.append(os.path.abspath('_ext')) # -- Run doxygen on readthedocs.org ------------------------------------------ -import subprocess, os read_the_docs_build = os.environ.get('READTHEDOCS', None) == 'True' if read_the_docs_build: - subprocess.call('cd source; doxygen', shell=True) - subprocess.call('javasphinx-apidoc --force -o source/java/ ../src/bindings/java/org/simgrid/msg', shell=True) - subprocess.call('rm source/java/packages.rst', shell=True) + subprocess.call('pwd', shell=True) # should be in docs/source + subprocess.call('doxygen', shell=True) + subprocess.call('_ext/javasphinx-apidoc --force -o java/ ../../src/bindings/java/org/simgrid/msg', shell=True) + subprocess.call('rm java/packages.rst', shell=True) # -- Project information ----------------------------------------------------- project = u'SimGrid' -copyright = u'2002-2018, The SimGrid Team' +copyright = u'2002-2019, The SimGrid Team' author = u'The SimGrid Team' # The short X.Y version -version = u'alpha 3.22' +version = u'3.23.3' # The full version, including alpha/beta/rc tags -release = u'3.21' - +#release = u'3.23 alpha' # -- General configuration --------------------------------------------------- @@ -52,26 +52,30 @@ release = u'3.21' extensions = [ 'sphinx.ext.todo', 'breathe', -# 'exhale', + # 'exhale', + 'sphinx.ext.autodoc', + 'sphinx.ext.intersphinx', + # 'sphinx.ext.napoleon', + 'sphinx.ext.autosummary', 'hidden_code_block', 'javasphinx', ] todo_include_todos = True -breathe_projects = { 'simgrid': '../build/xml' } +breathe_projects = {'simgrid': '../build/xml'} breathe_default_project = "simgrid" # Setup the exhale extension exhale_args = { # These arguments are required - "containmentFolder": "./api", - "rootFileName": "library_root.rst", - "rootFileTitle": "SimGrid Full API", - "doxygenStripFromPath": "..", + "containmentFolder": "./api", + "rootFileName": "library_root.rst", + "rootFileTitle": "SimGrid Full API", + "doxygenStripFromPath": "..", # Suggested optional arguments - "createTreeView": True, + "createTreeView": True, "exhaleExecutesDoxygen": False, # "exhaleUseDoxyfile": True, } @@ -82,7 +86,7 @@ primary_domain = 'cpp' # Add any paths that contain templates here, relative to this directory. -# templates_path = ['_templates'] +templates_path = ['_templates'] # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: ['.rst', '.md'] @@ -118,7 +122,7 @@ html_theme = 'sphinx_rtd_theme' # documentation. # html_theme_options = { - 'navigation_depth' : 4, + 'navigation_depth': 4, 'sticky_navigation': True, 'display_version': True, 'includehidden': True, @@ -147,11 +151,10 @@ htmlhelp_basename = 'SimGrid-doc' # -- Options for GitLab integration ------------------------------------------ html_context = { - "display_gitlab": True, # Integrate Gitlab + "display_gitlab": True, # Integrate Gitlab "gitlab_host": "framagit.org", "gitlab_user": "simgrid", "gitlab_repo": "simgrid", - "gitlab_version": "master", # Version - "conf_py_path": "/docs/source/", # Path in the checkout to the docs root + "gitlab_version": "master", # Version + "conf_py_path": "/docs/source/", # Path in the checkout to the docs root } -