X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Fconf.py.in;h=be0975ff7cd9159d19b0519dbb70f7cf50a432f5;hp=31257973cad7cac64dd1e6aa8ba01c6a2fb62798;hb=907c315580012ca7e75c640c88f79e3ff2239276;hpb=67312ab966a7c21fe835917978028643ffadd99e diff --git a/doc/salome/gui/SMESH/conf.py.in b/doc/salome/gui/SMESH/conf.py.in index 31257973c..be0975ff7 100644 --- a/doc/salome/gui/SMESH/conf.py.in +++ b/doc/salome/gui/SMESH/conf.py.in @@ -11,7 +11,9 @@ # All configuration values have a default; values that are commented out # serve to show the default. +import importlib import sys, os +import sphinx # If your extensions are in another directory, add it here. If the directory # is relative to the documentation root, use os.path.abspath to make it @@ -23,9 +25,21 @@ import sys, os # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = ['sphinx.ext.autodoc','sphinx.ext.autosummary', - 'sphinxcontrib.napoleon' -] +extensions = ['sphinx.ext.autodoc','sphinx.ext.autosummary'] +# 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 pdfbuilder to build a pdf with rst2pdf #extensions = ['rst2pdf.pdfbuilder'] @@ -101,7 +115,17 @@ pygments_style = 'sphinx' # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. -html_theme = '@SPHINX_THEME@' +if use_sphinx_rtd_theme: + html_theme = 'sphinx_rtd_theme' +else: + html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' + +themes_options = {} +themes_options['classic'] = { + 'body_max_width':'none', + 'body_min_width':0, +} +html_theme_options = themes_options.get(html_theme, {}) # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". @@ -167,7 +191,7 @@ htmlhelp_basename = 'smeshdoc' # ------------------------ # The paper size ('letter' or 'a4'). -latex_paper_size = 'a4' +#latex_paper_size = 'a4' # The font size ('10pt', '11pt' or '12pt'). latex_font_size = '10pt'