Merge pull request #28150 from mantidproject/28067_ReinstateCustomStyleSheetForQtHelp

Make the help pages use the custom Mantid style sheet

docs/source/conf-qthelp.py

@@ -16,6 +16,10 @@
 # Theme-specific options to customize the look and feel of a theme.
 # We config the bootstrap settings here, and apply CSS changes in
 # custom.css rather than here.
+
+# html_theme used to be used for both html and qthelp. From Sphinx 1.5.0 onwards the qthelp builder
+# for Python 3 uses qthelp_theme and qthelp_theme_options instead of the html_theme and html_theme_options.
+# Leave both in here in case old Sphinx version is ever used
 html_theme_options = {
     # Navigation bar title.
     'navbar_title': " ", # deliberate single space so it's not visible
@@ -36,5 +40,25 @@ html_theme_options = {
     'navbar_fixed_top': "false",
 }
 
+qthelp_theme_options = {
+    # Navigation bar title.
+    'navbar_title': " ", # deliberate single space so it's not visible
+    # Tab name for entire site.
+    'navbar_site_name': "Mantid",
+    # Add links to the nav bar. Third param of tuple is true to create absolute url.
+    'navbar_links': [
+    ],
+    # Do not show the "Show source" button.
+    'source_link_position': "no",
+    # Remove the local TOC from the nav bar
+    'navbar_pagenav': False,
+    # Hide the next/previous in the nav bar.
+    'navbar_sidebarrel': False,
+    # Use the latest version.
+    'bootstrap_version': "3",
+    # Ensure the nav bar always stays on top of page.
+    'navbar_fixed_top': "false",
+}
+
 plot_html_show_formats = False
 plot_html_show_source_link = False

docs/source/conf.py

@@ -134,6 +134,7 @@ pngmath_use_preview = True
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
+qthelp_theme = 'bootstrap'
 html_theme = 'bootstrap'
 
 # Add any paths that contain custom themes here, relative to this directory.