X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fgui%2Fconf.py.in;h=7160efdba91ecc89893efa7c7103fad1b70688a3;hb=06e7f5859095193fc7f498bd89a7d28009794f53;hp=97e16e27bfaeb67714b3423a853cbbcd56337b57;hpb=ce08a54d4205924141f3c748edc256a9eaa5d312;p=modules%2Fshaper.git diff --git a/doc/gui/conf.py.in b/doc/gui/conf.py.in index 97e16e27b..7160efdba 100644 --- a/doc/gui/conf.py.in +++ b/doc/gui/conf.py.in @@ -16,6 +16,8 @@ # 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 importlib import os import sys import sphinx @@ -32,20 +34,22 @@ import sphinx # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = ['sphinx.ext.autodoc','sphinx.ext.autosummary'] -try: - import sphinxcontrib.napoleon - extensions += ['sphinxcontrib.napoleon'] -except: - pass -try: - import sphinx_rtd_theme - extensions += ['sphinx_rtd_theme'] - use_rtd_theme = True -except: - use_rtd_theme = False +# Optional extensions +extra_extensions = ['sphinx_rtd_theme'] +if sphinx.version_info[:2] < (1,3): + extra_extensions += ['sphinxcontrib.napoleon'] +else: + extra_extensions += ['sphinx.ext.napoleon'] +for ext in extra_extensions: + try: + importlib.import_module(ext) + extensions.append(ext) + globals().update({'use_{}'.format(ext):True}) + except: + globals().update({'use_{}'.format(ext):False}) # Add any paths that contain templates here, relative to this directory. -templates_path = [os.path.join('@CMAKE_CURRENT_SOURCE_DIR@','templates')] +#templates_path = [os.path.join('@CMAKE_CURRENT_SOURCE_DIR@','templates')] # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: @@ -58,7 +62,7 @@ master_doc = 'index' # General information about the project. project = u'SHAPER' -copyright = u'2014-2019 CEA/DEN, EDF R&D' +copyright = u'2014-2023 CEA, EDF' # Copyright is shown via custom footer html_show_copyright = False @@ -68,9 +72,9 @@ html_show_copyright = False # built documents. # # The short X.Y version. -version = u'@SHAPER_Version@' +version = u'@SHAPER_VERSION@' # The full version, including alpha/beta/rc tags. -release = u'@SHAPER_Version@' +release = u'@SHAPER_VERSION@' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. @@ -96,7 +100,7 @@ pygments_style = 'sphinx' # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # -if use_rtd_theme: +if use_sphinx_rtd_theme: html_theme = 'sphinx_rtd_theme' else: html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' @@ -110,12 +114,16 @@ themes_options['classic'] = { 'body_max_width':'none', 'body_min_width':0, } +themes_options['sphinx_rtd_theme'] = { + 'prev_next_buttons_location':'both', +} + html_theme_options = themes_options.get(html_theme, {}) # 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, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = [os.path.join('@CMAKE_CURRENT_BINARY_DIR@','static')] +#html_static_path = [os.path.join('@CMAKE_CURRENT_BINARY_DIR@','static')] # -- Options for HTMLHelp output ------------------------------------------