From b96bbe0823ce0a3b17ed835ee7a8b090f6162288 Mon Sep 17 00:00:00 2001 From: vsr Date: Fri, 13 Mar 2020 16:18:38 +0300 Subject: [PATCH] bos #18858 Use sphinx_rtd_theme as theme for SALOME documentation built with Sphinx --- doc/tutorial/conf.py.in | 18 +++++++++++++++++- doc/user/conf.py.in | 18 +++++++++++++++++- 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/doc/tutorial/conf.py.in b/doc/tutorial/conf.py.in index e4618819b..c8db35055 100644 --- a/doc/tutorial/conf.py.in +++ b/doc/tutorial/conf.py.in @@ -25,6 +25,12 @@ import sphinx # 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.mathjax'] +try: + import sphinx_rtd_theme + extensions += ['sphinx_rtd_theme'] + use_rtd_theme = True +except: + use_rtd_theme = False # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -88,7 +94,17 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- -html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' +if use_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 style sheet to use for HTML and HTML Help pages. A file of that name # must exist either in Sphinx' static/ path, or in one of the custom paths diff --git a/doc/user/conf.py.in b/doc/user/conf.py.in index 41c42c7a1..b9f25236e 100644 --- a/doc/user/conf.py.in +++ b/doc/user/conf.py.in @@ -25,6 +25,12 @@ import sphinx # 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.mathjax'] +try: + import sphinx_rtd_theme + extensions += ['sphinx_rtd_theme'] + use_rtd_theme = True +except: + use_rtd_theme = False # Add any paths that contain templates here, relative to this directory. #templates_path = ['_templates'] @@ -89,7 +95,17 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- -html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic' +if use_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 style sheet to use for HTML and HTML Help pages. A file of that name # must exist either in Sphinx' static/ path, or in one of the custom paths -- 2.39.2