Salome HOME
bos #18858 Use sphinx_rtd_theme as theme for SALOME documentation built with Sphinx V9_5_0a2
authorvsr <vsr@opencascade.com>
Fri, 13 Mar 2020 12:45:00 +0000 (15:45 +0300)
committervsr <vsr@opencascade.com>
Fri, 13 Mar 2020 12:45:00 +0000 (15:45 +0300)
doc/dev/sphinx/conf.py.in

index ae9b6d7e0b8b05dc16bc57e98b9d2f442136f0a0..b08706a56653bbbd8ec1817bbc3df00d3224eb2d 100644 (file)
@@ -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.autodoc']
+try:
+  import sphinx_rtd_theme
+  extensions += ['sphinx_rtd_theme']
+  use_rtd_theme = True
+except:
+  use_rtd_theme = False
 
 # Uncomment the following line to build the links with Python documentation
 # (you might need to set http_proxy environment variable for this to work)
@@ -104,8 +110,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 = 'default' if sphinx.version_info[:2] < (1,3) else 'classic'
-#html_theme_options = {}
+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, {})
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = ['themes']
@@ -130,7 +145,7 @@ html_theme = 'default' if sphinx.version_info[:2] < (1,3) else 'classic'
 # The stylecheet file will be searched within the static path, while
 # the layout.html file will be searched within the template path
 # (Note that this parameter can't be used together with html_theme. Exclusive)
-html_style = 'medcalc.css'
+#html_style = 'medcalc.css'
 
 # 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,