X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/94a795eaa220aea84b8094fbe7f61e3b217b55af..9f808ab5abb0829e8621127b3d27dea8630e117a:/docs/source/conf.py diff --git a/docs/source/conf.py b/docs/source/conf.py index 56a3dd68e1..286f452322 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -12,31 +12,32 @@ # 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('source/_ext/javasphinx-apidoc --force -o source/java/ ../src/bindings/java/org/simgrid/msg', shell=True) + subprocess.call('rm source/java/packages.rst', shell=True) # -- Project information ----------------------------------------------------- project = u'SimGrid' -copyright = u'2018, The SimGrid Team' +copyright = u'2002-2019, The SimGrid Team' author = u'The SimGrid Team' # The short X.Y version -version = u'3.21' +version = u'3.23.3' # The full version, including alpha/beta/rc tags -release = u'3.21' - +#release = u'3.23 alpha' # -- General configuration --------------------------------------------------- @@ -50,25 +51,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, } @@ -79,7 +85,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'] @@ -115,7 +121,7 @@ html_theme = 'sphinx_rtd_theme' # documentation. # html_theme_options = { - 'navigation_depth' : 4, + 'navigation_depth': 4, 'sticky_navigation': True, 'display_version': True, 'includehidden': True, @@ -144,11 +150,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 } -